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:

export NEODOMAIN_ACCESS_TOKEN="your_access_token_here"

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

Image Generation

Get Available Models

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

Generate Images

# 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

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:

# Single reference image
python3 {baseDir}/scripts/generate_image_ref.py \
  --prompt "A woman walking in a forest" \
  --reference-image "https://example.com/character1.jpg" \
  --model "doubao-seedream-5-0-260128" \
  --aspect-ratio "16:9" \
  --token $NEODOMAIN_ACCESS_TOKEN

# Multiple reference images (up to 10)
python3 {baseDir}/scripts/generate_image_ref.py \
  --prompt "A conversation between two people" \
  --reference-image "https://example.com/character1.jpg" \
  --reference-image "https://example.com/character2.jpg" \
  --reference-image "https://example.com/character3.jpg" \
  --model "doubao-seedream-5-0-260128" \
  --aspect-ratio "16:9" \
  --token $NEODOMAIN_ACCESS_TOKEN

Video Generation

Get Available Models

python3 {baseDir}/scripts/video_models.py --token $NEODOMAIN_ACCESS_TOKEN

Generate Videos

Text-to-Video

python3 {baseDir}/scripts/generate_video.py \
  --prompt "A serene lake at dawn with mist rising from the water" \
  --model "veo3" \
  --generation-type "TEXT_TO_VIDEO" \
  --aspect-ratio "16:9" \
  --resolution "720p" \
  --duration "8s" \
  --token $NEODOMAIN_ACCESS_TOKEN

Image-to-Video

python3 {baseDir}/scripts/generate_video.py \
  --prompt "The camera slowly pans across the landscape" \
  --model "veo3" \
  --generation-type "IMAGE_TO_VIDEO" \
  --first-frame "https://example.com/image.jpg" \
  --aspect-ratio "16:9" \
  --resolution "720p" \
  --duration "8s" \
  --token $NEODOMAIN_ACCESS_TOKEN

Motion Control (Image + Video Reference)

python3 {baseDir}/scripts/motion_control.py \
  --image "https://example.com/ref_image.jpg" \
  --video "https://example.com/ref_video.mp4" \
  --prompt "Make the character dance" \
  --mode "pro" \
  --duration 5000 \
  --token $NEODOMAIN_ACCESS_TOKEN

Parameters

Authentication

重要: 每次 token 过期或首次使用时，动态询问用户登录账号（手机号/邮箱），不要硬编码保存。

If you need to obtain an access token:

# 1. 发送验证码 (询问用户手机号或邮箱)
python3 {baseDir}/scripts/login.py --send-code --contact "用户手机号或邮箱"

# 2. 用户提供验证码后，登录获取 token
python3 {baseDir}/scripts/login.py --login --contact "用户手机号或邮箱" --code "验证码"

The login script will output an access token that you can store in NEODOMAIN_ACCESS_TOKEN.

Workflow

1. Authenticate (first time only): Get your access token
2. Get models: Check available models for your needs
3. Generate: Create content with appropriate parameters
4. Wait: Scripts automatically poll for results
5. Download: Images/videos saved to output directory

Output

• Images: *.jpg, *.png, or *.webp files
• Videos: *.mp4 files with thumbnail
• metadata.json with generation details