neodomain-ai

# Neodomain AI Content Generator

Generate images and videos using the Neodomain AI platform API.

## Setup

Set your access token as an environment variable:

```bash
export NEODOMAIN_ACCESS_TOKEN="your_access_token_here"
```

Or pass it directly to scripts via `--token` flag.

## Image Generation

### Get Available Models

```bash
python3 {baseDir}/scripts/image_models.py --token $NEODOMAIN_ACCESS_TOKEN
```

### Generate Images

```bash
# Basic text-to-image
python3 {baseDir}/scripts/generate_image.py --prompt "A futuristic city at sunset" --token $NEODOMAIN_ACCESS_TOKEN

# With options
python3 {baseDir}/scripts/generate_image.py \
  --prompt "A beautiful mountain landscape" \
  --negative-prompt "blurry, low quality" \
  --model "doubao-seedream-4-0" \
  --aspect-ratio "16:9" \
  --num-images 4 \
  --size "2K" \
  --output-dir ./output/images \
  --token $NEODOMAIN_ACCESS_TOKEN
```

### Parameters

| Parameter | Description | Default |
|-----------|-------------|---------|
| `--prompt` | Text description for image generation | Required |
| `--negative-prompt` | Things to exclude from image | Empty |
| `--model` | Model name (see models list) | `gemini-3.1-flash-image-preview` |
| `--aspect-ratio` | Image aspect ratio: `1:1`, `16:9`, `9:16`, `4:3`, `3:4` | `1:1` |
| `--num-images` | Number of images to generate: `1` or `4` | `1` |
| `--size` | Image size: `1K`, `2K`, `4K` | `2K` |
| `--guidance-scale` | Prompt adherence (1.0-20.0) | `7.5` |
| `--seed` | Random seed for reproducibility | Random |
| `--output-format` | Output format: `jpeg`, `png`, `webp` | `jpeg` |
| `--output-dir` | Where to save images | `./output` |

### Image Generation with Reference Images

Use `generate_image_ref.py` to generate images with character reference(s). Supports up to 10 reference images per generation:

```bash
# Single reference image
python3 {baseDir}/scripts/generate_image_ref.py \
  --prompt "A woman walking in a forest" \
  --reference-image "https://example.com/character1.j...