neodomain-ai

name	neodomain-ai
description	Generate images and videos via Neodomain AI API. Supports text-to-image, image-to-video, text-to-video, and motion control video generation. Use when user wants to create AI-generated images or videos using the Neodomain platform.

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

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:

# 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

Parameter	Description	Default
--reference-image	Reference image URL(s) - can specify multiple (up to 10)	-

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

Parameter	Description	Default
--prompt	Text description for video	Required
--model	Model name: veo3, hailuo02, doubao	veo3
--generation-type	Type: TEXT_TO_VIDEO, IMAGE_TO_VIDEO, REFERENCE_TO_VIDEO	TEXT_TO_VIDEO
--first-frame	First frame image URL (for IMAGE_TO_VIDEO)	-
--last-frame	Last frame image URL (optional)	-
--image-urls	Reference images (comma-separated, for REFERENCE_TO_VIDEO)	-
--aspect-ratio	Video aspect: 16:9, 9:16, 1:1	16:9
--resolution	Resolution: 720p, 768p, 1080p	720p
--duration	Duration: 4s, 5s, 6s, 8s, 10s, 16s	8s
--fps	Frame rate	24
--seed	Random seed	Random
--generate-audio	Generate audio (true/false)	false
--enhance-prompt	Enhance prompt (true/false)	false
--output-dir	Where to save output	./output

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