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.
Generate images and videos using the Neodomain AI platform API.
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.
python3 {baseDir}/scripts/image_models.py --token $NEODOMAIN_ACCESS_TOKEN
# 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
| 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 |
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) | - |
python3 {baseDir}/scripts/video_models.py --token $NEODOMAIN_ACCESS_TOKEN
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
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
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
| 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 |
重要: 每次 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.
*.jpg, *.png, or *.webp files*.mp4 files with thumbnailmetadata.json with generation details