SeeGen AI API

Overview

SeeGen AI is a unified generation API: one consistent set of endpoints to run multiple leading AI video and image models. Choose a model with the model parameter — authentication, task submission, status polling, and webhooks work the same way across all of them.

Currently available models:

• Video — Seedance 2.5 (sd2.5), Seedance 2.0 Pro (sd2), Fast (sd2-fast), Mini (sd2-mini), Grok Imagine Video 1.5 (grok-imagine-video-1.5) and Lite (grok-imagine-video-1.5-lite), Wan 3.0 Video Prime (wan3.0-video-prime), Wan 3.0 Video (wan3.0-video). Grok supports 1–15 seconds with audio. Standard 1.5 supports native 1080p for text or single-image input and up to 14 reference images; Lite supports text or one image, with 1080p upscaled from 720p.
• Image — GPT Image 2 (gpt-image-2), Nano Banana 2.1 / 2 (nano-banana-2.1, nano-banana-2), Nano Banana Pro (nano-banana-pro), Seedream 5.0 Lite (seedream-v5.0-lite), Seedream 5.0 Pro (seedream-v5.0-pro) Qwen Image 2.1 Pro and Turbo support 1K/2K generation and editing with up to 10 reference images.

Why SeeGen AI?

More Reasons to Choose SeeGen AI:

• More than Seedance 2.0: Wan 3.0, Nano Banana, ChatGPT Image, and more.
• No subscription is required — pay as you go
• Fast access to the latest models
• 24/7 customer support
• Support for official model-related inquiries
• Console access for developers
• Open to both businesses and individual users

Pricing

🎉 Limited-time offer: 33% off all image generation — all image prices below are already discounted.

Check your balance: GET /api/v1/account/credits

Automatic Recharge for API Accounts

Your API key and SeeGen AI dashboard use the same account-level credit balance. Auto Recharge can keep that balance funded for API workloads, but it must be configured from the Credits page; there is currently no separate configuration API.

Authentication

All API requests require a Bearer token in the Authorization header. You can create and manage API keys from your Account Settings.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://seegen.ai/api/v1/account/credits

Quick Start

Generate a video in two steps: create a task, then poll for the result.

set -eu
# 1. Create once. Save the returned IDs; never blindly retry a timed-out create.
CREATED=$(curl --fail-with-body --silent --show-error --max-time 120 -X POST \
  -H "Authorization: Bearer $SEEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "prompt": "A golden retriever running on the beach at sunset",
      "duration": "5s",
      "resolution": "1280x720"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask)
printf '%s\n' "$CREATED" | jq .
TASK_ID=$(printf '%s' "$CREATED" | jq -er '.taskId')

# 2. Poll for up to 15 minutes. A polling timeout does not cancel the task.
DEADLINE=$(( $(date +%s) + 900 ))
while true; do
  RESULT=$(curl --fail-with-body --silent --show-error --max-time 30 \
    -H "Authorization: Bearer $SEEGEN_API_KEY" \
    "https://seegen.ai/api/v1/jobs/queryTask?taskId=$TASK_ID")
  STATUS=$(printf '%s' "$RESULT" | jq -er '.status')
  if [ "$STATUS" = "COMPLETED" ]; then
    printf '%s\n' "$RESULT" | jq .
    break
  fi
  if [ "$STATUS" = "FAILED" ]; then
    printf '%s\n' "$RESULT" | jq .
    exit 1
  fi
  if [ "$(date +%s)" -ge "$DEADLINE" ]; then
    echo "Still processing: query taskId=$TASK_ID later" >&2
    exit 1
  fi
  sleep 5
done

Endpoints

Choose a Model (Video)

Choose a video model by workflow, native resolution, speed, and price; combine this table with the Pricing section to estimate cost.

T2V = Text to Video · I2V = Image to Video (first frame) · First–Last = first + last keyframe · Multi-Ref = reference images (Seedance and Wan also support video / audio) · R2V = 1–9 reference images with character markers

Seedance 2.0 / 2.0 Fast / 2.0 Mini / Seedance 2.5

Text to Video

Generate a video from a text prompt. No images required.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "prompt": "A futuristic city with flying cars at night, neon lights reflecting on wet streets",
      "duration": "5s",
      "resolution": "1280x720"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Image to Video

Animate a static image into a video. Provide one image URL as the starting frame.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "urls": ["https://example.com/photo.jpg"],
      "prompt": "The woman slowly turns her head and smiles",
      "duration": "5s"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

First & Last Frame

Define the starting and ending frames, and the model generates the transition between them. Uses videoInputMode: "keyframe".

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "urls": [
        "https://example.com/first-frame.jpg",
        "https://example.com/last-frame.jpg"
      ],
      "prompt": "Smooth camera transition from day to night",
      "duration": "5s",
      "videoInputMode": "keyframe"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Multi-Reference

Use multiple reference images, videos, and audio files to guide generation. Uses videoInputMode: "reference". For sd2.5 this is the default reference sub-task; see Video Edit & Extend below to edit or continue an existing video instead.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "inputs": {
      "urls": [
        "https://example.com/ref1.jpg",
        "https://example.com/ref2.jpg"
      ],
      "videoUrls": ["asset://asset-motion-video"],
      "audioUrls": ["https://example.com/audio.mp3"],
      "prompt": "Character walks through a garden",
      "duration": "5s",
      "videoInputMode": "reference",
      "resolution": "1280x720"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Video Edit & Extend

sd2.5 splits reference-based generation into three sub-tasks. Omit mode for ordinary reference generation, set mode: "edit" to edit an existing video, or mode: "extend" to continue one. Both require at least one video in videoUrls and always output the source video's aspect ratio.

Put the video you want to operate on first in videoUrls and refer to it as "Video 1" in your prompt. edit forces the output length to match that first (source) video, which must be 4–30s, so any duration you send is ignored; billing uses the source-video duration as the output duration, plus all reference videos as input. extend accepts 1–3 clips stitched in order, and the duration you request is the output length of this generation (unrelated to the source length) — billed like ordinary reference generation.

The 2.0-family models (sd2 / sd2-fast / sd2-mini) also accept mode: "edit" and mode: "extend": they infer the operation from your prompt (describe the edit or continuation explicitly), the aspect ratio follows the source video, and duration stays under your control with ordinary billing.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2.5",
    "inputs": {
      "mode": "edit",
      "videoInputMode": "reference",
      "videoUrls": ["asset://asset-source-video"],
      "urls": ["https://example.com/annotation-at-1.2s.png"],
      "source_frame_timestamps_ms": [1200],
      "prompt": "Replace the marked object with a red umbrella",
      "outputResolution": "720p"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Seedance 2.5 Draft to Final

Submit an sd2.5 task with inputs.draft: true to generate a native 480P draft. Do not send outputResolution or upscaleResolution: the API fixes draft output at 480P and rejects either field if supplied, including outputResolution: "480p". This works for text, keyframe, and reference generation, but not edit or extend. Each draft and final task is billed separately.

# 1. Create a 480P draft. Save both taskId and orderId from the response.
curl -X POST https://seegen.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"sd2.5","inputs":{"prompt":"A blue cube slowly rotates on a white background","duration":"4s","draft":true}}'

# 2. Poll by taskId until status is COMPLETED, then review the draft output.
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/jobs/queryTask?taskId=YOUR_DRAFT_TASK_ID"

# 3. Within 7 days of draft creation, generate the 1080P final from its SeeGen orderId.
curl -X POST https://seegen.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"sd2.5","inputs":{"draftSourceOrderId":"YOUR_DRAFT_ORDER_ID"}}'

Save the orderId returned by createTask (or retrieve it through queryTask), and wait until the draft task is COMPLETED. Submit a second sd2.5 task with inputs.draftSourceOrderId set to that orderId. The server verifies that the completed draft belongs to your account, reuses its original inputs and seed, and renders a native 1080P final. Other final inputs are ignored. A matching composition is expected, but pixel-identical output is not guaranteed.

Important rules

• Which ID? Use the SeeGen orderId returned by createTask or queryTask, not the taskId. SeeGen looks up the draft's gateway task ID internally; do not send a draft_task.id field to this API.
• Why are the fields different from ARK? In the provider API, resolution selects output quality and content[].draft_task.id identifies the draft. In SeeGen, resolution is an aspect-ratio preset and outputResolution selects quality for ordinary tasks. For a draft, omit outputResolution; for the final, send draftSourceOrderId. Do not copy a provider request into this API unchanged.
• When? The draft must be COMPLETED and belong to your account. A draft can be used for final rendering for 7 days from its creation. After that, create a new draft.
• What is reused? The final automatically uses the draft's prompt, reference media, duration, aspect ratio, seed, audio setting, and task type. Send only draftSourceOrderId in final inputs; other generation inputs are ignored. You may set a new top-level callBackUrl for the final task.
• How is it billed? Draft and final are separate paid tasks: the draft uses the 480P rate, and the final uses the native 1080P rate. If the draft used input videos, final pricing uses those original input-video durations; the draft video itself is not counted as an additional input video.

Query draft and final relations

GET /api/v1/jobs/relations with an orderId. For a draft, the response lists all finals created from it. For a final, it returns the sourceDraft. Only orders belonging to the API key owner are visible.

# A draft orderId returns its finals, oldest first (including queued and failed tasks).
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/jobs/relations?orderId=YOUR_DRAFT_ORDER_ID&limit=20"

# A final orderId returns its source draft.
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/jobs/relations?orderId=YOUR_FINAL_ORDER_ID"

The response contains kind (draft or final), sourceDraft, finals, totalCount, and nextCursor. Each related task includes orderId, taskId, status, createTime, and a URL when completed. For drafts, pass nextCursor as cursor to load more finals (limit: 1–50). Deleted or archived orders are hidden.

{
  "orderId": "YOUR_DRAFT_ORDER_ID",
  "kind": "draft",
  "sourceDraft": null,
  "finals": [
    {
      "orderId": "FINAL_ORDER_ID",
      "taskId": "FINAL_TASK_ID",
      "status": "COMPLETED",
      "createTime": 1790192800000,
      "url": "https://example.com/final.mp4"
    }
  ],
  "totalCount": 1,
  "nextCursor": null
}

Seedance Parameters Reference

Complete reference of all inputs parameters for the sd2 / sd2-fast / sd2-mini / sd2.5 models.

Top-level request fields: model (required), inputs (required), callBackUrl (optional webhook URL).

Seedance Assets

Seedance assets are images, videos, and audio files that go through the ByteDance Volcano review process before they can be used in Seedance video generation tasks. Upload an asset, wait for it to become ACTIVE, then use its asset:// URL in your Seedance task.

Platform Content Precheck

When material review is enabled for your account, uploads are also reviewed by SeeGen across all generation models. Upload, status and list responses include a separate contentReview object. It does not replace the original supplier status.

Only ALLOW or DISABLED permits use under the platform policy; the original model and supplier requirements still apply. PROCESSING means wait and poll asset status. PENDING means request a review. BLOCK or NEEDS_REPHRASE means replace the material. SERVICE_UNAVAILABLE means the review could not finish and can be retried. Generation rejected by this precheck does not charge credits.

To review an older upload or retry a temporary review failure, send its numeric assetId to POST /api/v1/assets/review. The endpoint returns assetId and contentReview; it does not retry or change supplier review.

{ "assetId": 123, "contentReview": { "status": "PROCESSING", "reviewId": "review-id" } }

Upload Asset

Two ways to upload: send a local file directly (multipart/form-data), or submit a publicly accessible HTTPS URL. Either way the asset is processed and reviewed automatically.

Method A — direct file upload (multipart/form-data)

Send a local file with no image host required. The media type is detected from the file's bytes (the filename extension is not trusted). Allowed: images (jpg/png/webp/gif/bmp/tiff/heic), videos (mp4/mov), audio (wav/mp3). Max 50MB per file (image ≤30MB, video ≤50MB, audio ≤15MB).

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@/path/to/photo.jpg" \
  -F "name=my-photo" \
  https://seegen.ai/api/v1/assets/upload

Method B — by URL (application/json)

If the file is already hosted at a public HTTPS URL.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg",
    "type": "IMAGE",
    "name": "my-photo"
  }' \
  https://seegen.ai/api/v1/assets/upload

Upload Response

{
  "assetId": 123,
  "volcAssetId": "asset-20260326-abc123",
  "type": "IMAGE",
  "status": "PROCESSING",
  "failReason": null,
  "url": "https://example.com/photo.jpg",
  "name": "my-photo",
  "createdAt": 1711234567890
}

Query Asset Status

Poll an asset's review status. When status is PROCESSING, the endpoint automatically checks for updates from the review system.

# Query by asset ID (numeric)
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/status?assetId=123"

# Query by volcAssetId (string)
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/status?assetId=asset-20260326-abc123"

List Assets

List your uploaded assets with optional filtering by type and status. Supports cursor-based pagination.

# List all assets
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/list"

# Filter by type and status
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/list?type=IMAGE&status=ACTIVE&limit=10"

# Paginate with cursor
curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/assets/list?cursor=100&limit=20"

List Response

{
  "items": [
    {
      "assetId": 123,
      "volcAssetId": "asset-20260326-abc123",
      "type": "IMAGE",
      "status": "ACTIVE",
      "failReason": null,
      "url": "https://example.com/photo.jpg",
      "name": "my-photo",
      "width": 1920,
      "height": 1080,
      "size": 245000,
      "duration": null,
      "createdAt": 1711234567890
    }
  ],
  "nextCursor": 122
}

Using Assets in Tasks

Once an asset is ACTIVE, use its volcAssetId with the asset:// protocol in your task's URLs:

{
  "model": "sd2",
  "inputs": {
    "urls": ["asset://asset-20260326-abc123"],
    "prompt": "The person slowly looks up and smiles",
    "duration": "5s"
  }
}

curl -X POST https://seegen.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SEEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-video-1.5",
  "inputs": {
    "prompt": "A blue toy cube slowly rotates on a white table",
    "duration": "5s",
    "outputResolution": "480p",
    "ratio": "16:9",
    "generateAudio": true
  }
}'

curl -X POST https://seegen.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SEEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-video-1.5",
  "inputs": {
    "prompt": "A blue toy cube slowly rotates on a white table",
    "duration": "5s",
    "outputResolution": "480p",
    "generateAudio": true,
    "urls": [
      "https://example.com/first.png"
    ]
  }
}'

curl -X POST https://seegen.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SEEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-video-1.5",
  "inputs": {
    "prompt": "A blue toy cube slowly rotates on a white table",
    "duration": "5s",
    "outputResolution": "480p",
    "ratio": "16:9",
    "generateAudio": true,
    "urls": [
      "https://example.com/first.png",
      "https://example.com/last.png"
    ]
  }
}'

curl -X POST https://seegen.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SEEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-video-1.5",
  "inputs": {
    "prompt": "A blue toy cube slowly rotates on a white table",
    "duration": "5s",
    "outputResolution": "480p",
    "ratio": "16:9",
    "generateAudio": true,
    "urls": [
      "https://example.com/reference.png"
    ],
    "videoInputMode": "reference"
  }
}'

Wan 3.0 Video & Wan 3.0 Video Prime

Wan 3.0 supports text-to-video, first-frame image-to-video, first-and-last-frame interpolation, mixed image/video/audio references, video editing, and video extension. wan3.0-video-prime accepts the same inputs as wan3.0-video and is optimized for faster generation.

Both aliases use SeeGen's asynchronous API: POST /api/v1/jobs/createTask returns a taskId; poll GET /api/v1/jobs/queryTask?taskId=... or provide callBackUrl for the terminal result.

Supported output: fixed durations of 2–30 seconds at native 480p, 720p, or 1080p, without a watermark. Automatic duration (duration: -1), 2K/4K output, and a custom watermark setting are not supported. Upload reference media first, then use the returned HTTPS URL.

Text-to-Video

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "inputs": {
      "prompt": "A red paper boat glides across a calm pond at sunrise, locked camera, no text.",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "16:9",
      "generateAudio": true,
      "promptExtend": true,
      "seed": 12345
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Image-to-Video (First Frame)

Upload Wan media with multipart POST /api/v1/assets/upload?model=wan3.0-video (or the Prime alias), then use the returned owned HTTPS url in generation inputs. The returned assetId is only the SeeGen material record ID; do not send it in generation inputs.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@/path/to/first-frame.webp" \
  "https://seegen.ai/api/v1/assets/upload?model=wan3.0-video"

{
  "assetId": 123,
  "type": "IMAGE",
  "status": "ACTIVE",
  "url": "https://static.seegen.ai/materials/api/.../first-frame.webp"
}

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "inputs": {
      "urls": ["https://static.seegen.ai/materials/api/.../first-frame.webp"],
      "videoInputMode": "keyframe",
      "prompt": "The subject looks toward the camera as morning mist drifts past.",
      "duration": "5s",
      "outputResolution": "1080p",
      "generateAudio": true
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

First & Last Frame

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "inputs": {
      "urls": [
        "https://static.seegen.ai/materials/api/.../first-frame.webp",
        "https://static.seegen.ai/materials/api/.../last-frame.webp"
      ],
      "videoInputMode": "keyframe",
      "prompt": "A smooth continuous transition from sunrise to night.",
      "duration": "8s",
      "outputResolution": "720p"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Multi-Reference (Images, Videos & Audio)

Set videoInputMode: "reference", then send at least one supported media input through urls, videoUrls, or audioUrls; the prompt is optional. Refer to media by order as Image1, Image2, Video1, or Audio1. Upload each reference with the Wan multipart endpoint first, then use its returned owned HTTPS URL.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "inputs": {
      "videoInputMode": "reference",
      "urls": ["https://static.seegen.ai/materials/api/.../reference-image.webp"],
      "videoUrls": ["https://static.seegen.ai/materials/api/.../source-video.mp4"],
      "audioUrls": ["https://static.seegen.ai/materials/api/.../reference-audio.mp3"],
      "prompt": "Use Image1 for identity, Video1 for motion, and Audio1 for timing.",
      "duration": "10s",
      "outputResolution": "720p",
      "ratio": "16:9",
      "generateAudio": true,
      "promptExtend": true
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Video Edit

Upload the source video first, then use mode: "edit" with videoInputMode: "reference". In the required prompt, describe how to edit Video1, the first video in videoUrls. The aspect ratio is Auto; choose the output duration. The reference-media limits and pricing below apply to both editing and extension.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "inputs": {
      "mode": "edit",
      "videoInputMode": "reference",
      "videoUrls": ["https://static.seegen.ai/materials/api/.../source-video.mp4"],
      "prompt": "Transform Video1 into clay animation, keeping the characters and camera movement.",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "adaptive"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Video Extend

Use mode: "extend" with a source video and an instruction prompt, such as "Extend Video1 forward", followed by what happens next. Set ratio: "adaptive". The selected duration is the generated output length, not the source length plus the extension. File-to-video and webpage-to-video are not supported.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "inputs": {
      "mode": "extend",
      "videoInputMode": "reference",
      "videoUrls": ["https://static.seegen.ai/materials/api/.../source-video.mp4"],
      "prompt": "Extend Video1 forward, continuing the motion of the character and keeping the scene consistent.",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "adaptive"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Wan 3.0 Parameters Reference

Both Wan 3.0 models accept the same inputs fields. Choose an output duration from 2 to 30 seconds in whole-second increments.

Choose a Model (Image)

Image models take a prompt (and optionally reference images) and return one image per task. Each request is billed per image using the selected model's tier (or a flat rate for Seedream Lite). Failed tasks are refunded automatically. There is no batch parameter — to generate multiple variations, call createTask once per image.

GPT Image 2.5 Flare / Sunburst

GPT Image 2.5 Flare focuses on fast image generation and editing. Sunburst focuses on detailed image generation and precise edits. Both work with text prompts and reference images.

Available in the workspace, Playground, and API. Both models accept the parameters below: medium/high/xhigh/max quality, 1K/2K/4K presets, and PNG/JPEG/WebP output. Actual dimensions may differ from the preset. JPEG and WebP are converted from the generated PNG without resizing. Each API task generates one image.

Text-to-Image

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "inputs": {
      "prompt": "A neon-lit cyberpunk alley at midnight, photoreal",
      "quality": "medium",
      "resolution": "2k",
      "aspectRatio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Image-to-Image (Editing)

Pass 1–10 reference images via urls. The model will use them as visual context for the edit described in prompt.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "inputs": {
      "urls": ["https://example.com/portrait.jpg"],
      "prompt": "Restyle as oil painting",
      "quality": "medium",
      "resolution": "1k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

GPT Image 2.5 Parameters Reference

Complete reference of all inputs parameters for the gpt-image-2.5-flare model.

Credits per image scale by resolution and quality — see the Pricing section for the full table.

GPT Image 2

OpenAI's GPT Image 2 model for high-quality text-to-image and image-to-image editing. One workflow handles both modes — pass urls to switch into edit mode automatically. Output is delivered via R2 in the format you request (PNG / JPEG / WEBP). Model name: gpt-image-2.

Text-to-Image

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "inputs": {
      "prompt": "A neon-lit cyberpunk alley at midnight, photoreal",
      "quality": "medium",
      "resolution": "2k",
      "aspectRatio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Image-to-Image (Editing)

Pass 1–10 reference images via urls. The model will use them as visual context for the edit described in prompt.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "inputs": {
      "urls": ["https://example.com/portrait.jpg"],
      "prompt": "Restyle as oil painting",
      "quality": "medium",
      "resolution": "1k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

GPT Image 2 Parameters Reference

Complete reference of all inputs parameters for the gpt-image-2 model.

Credits per image scale by resolution and quality — see the Pricing section for the full table.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2.1",
    "inputs": {
      "prompt": "A neon-lit cyberpunk alley at midnight, photoreal",
      "resolution": "2k",
      "aspectRatio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2.1",
    "inputs": {
      "urls": ["https://example.com/portrait.jpg"],
      "prompt": "Restyle as oil painting",
      "resolution": "2k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Nano Banana Pro

Nano Banana Pro is a high-fidelity image model with broader aspect-ratio coverage than gpt-image-2 — adds portrait/landscape presets (3:2, 2:3, 4:5, 5:4) and cinematic 21:9. One workflow handles both modes — pass urls to switch into edit mode automatically. Model name: nano-banana-pro.

Text-to-Image

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "inputs": {
      "prompt": "A neon-lit cyberpunk alley at midnight, photoreal",
      "resolution": "2k",
      "aspectRatio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Image-to-Image (Editing)

Pass 1–10 reference images via urls. The model will use them as visual context for the edit described in prompt.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "inputs": {
      "urls": ["https://example.com/portrait.jpg"],
      "prompt": "Restyle as oil painting",
      "resolution": "2k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Nano Banana Pro Parameters Reference

Complete reference of all inputs parameters for the nano-banana-pro model.

Credits per image scale by resolution — see the Pricing section for the full table.

Seedream 5.0 Lite

Fast text-to-image and image-to-image generation at 2K or 4K with 15 aspect ratios. Model name: seedream-v5.0-lite.

Text-to-Image

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-lite",
    "inputs": {
      "prompt": "A cinematic product photograph, soft studio light",
      "resolution": "2k",
      "aspectRatio": "1:1"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Image-to-Image (Editing)

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-lite",
    "inputs": {
      "prompt": "Restyle the references as a premium fashion campaign",
      "urls": ["https://example.com/reference.png"],
      "resolution": "4k",
      "aspectRatio": "3:4"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Seedream 5.0 Lite Parameters

Seedream 5.0 Pro

High-fidelity generation and editing at 1K or 2K. Model name: seedream-v5.0-pro.

Text-to-Image

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-pro",
    "inputs": {
      "prompt": "Editorial portrait with dramatic rim lighting",
      "resolution": "2k",
      "aspectRatio": "3:4"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Image-to-Image (Editing)

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-v5.0-pro",
    "inputs": {
      "prompt": "Turn the reference into a cinematic poster",
      "urls": ["https://example.com/reference.png"],
      "resolution": "2k",
      "aspectRatio": "1:2"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Seedream 5.0 Pro Parameters

curl -X POST https://seegen.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SEEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-2.1-pro",
  "inputs": {
    "prompt": "A blue glass cube on a white table",
    "resolution": "1k",
    "aspectRatio": "1:1"
  }
}'

curl -X POST https://seegen.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SEEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-2.1-pro",
  "inputs": {
    "prompt": "Restyle the reference image as a watercolor painting",
    "resolution": "1k",
    "aspectRatio": "1:1",
    "urls": [
      "https://example.com/reference.png"
    ]
  }
}'

Video Upscaler

Create Task

POST /api/v1/upscale/create

# source.url accepts ANY https video URL — your own CDN, OR a file you first
# uploaded to us via /api/v1/assets/upload (pass the r2Url it returns). No need
# to declare which: we detect it. External URLs are validated; our own are trusted.
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": { "type": "url", "url": "https://your-cdn.com/video.mp4" },
    "targetResolution": "2k",
    "callBackUrl": "https://your-server.com/webhook"
  }' \
  https://seegen.ai/api/v1/upscale/create

Create Response

{
  "taskId": "n770mo4sh6rpi690ff3gwymx",
  "orderId": "ord_2026...",
  "status": "validating"
}

Query Status

GET /api/v1/upscale/query?taskId=...

Status progresses validating → processing → completed / failed.

curl -H "Authorization: Bearer $API_KEY" \
  "https://seegen.ai/api/v1/upscale/query?taskId=n770mo4sh6rpi690ff3gwymx"

Completed Response

{
  "taskId": "n770mo4sh6rpi690ff3gwymx",
  "status": "completed",
  "targetResolution": "2k",
  "creditsConsumed": 900,
  "result": {
    "url": "https://static.seegen.ai/standalone-upscale/results/...mp4",
    "probedDurationSeconds": 30,
    "probedSourceResolution": "1280x720"
  },
  "error": null,
  "createdAt": "2026-04-29T01:23:45.000Z",
  "finishedAt": "2026-04-29T01:35:01.000Z"
}

Failed Response

{
  "taskId": "n770mo4sh6rpi690ff3gwymx",
  "status": "failed",
  "creditsConsumed": null,
  "result": null,
  "error": {
    "code": "SOURCE_RESOLUTION_TOO_HIGH",
    "message": "Source 3840x2160 is not below target 4k"
  }
}

Error Codes

Common errors you can act on. Other failures return a self-explanatory message field — read that before assuming the code is one of these.

Webhook Callback

Instead of polling, you can provide a callBackUrl to receive results automatically when a task completes or fails.

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2",
    "callBackUrl": "https://your-server.com/webhook/callback",
    "inputs": {
      "prompt": "A cat playing piano",
      "duration": "5s"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Callback Payload

When the task finishes, we send a POST request to your URL with the same format as the queryTask response:

{
  "taskId": "task_abc123",
  "orderId": "order_abc123",
  "model": "sd2",
  "status": "COMPLETED",
  "creditsUsed": 200,
  "output": [
    {
      "url": "https://static.seegen.ai/videos/result.mp4",
      "width": 1280,
      "height": 720
    }
  ],
  "error": null,
  "createTime": 1711234567890,
  "completeTime": 1711234612345
}

Response Format

createTask Response

{ "taskId": "task_abc123", "orderId": "order_abc123" }

queryTask Response

{
  "taskId": "task_abc123",
  "orderId": "order_abc123",
  "model": "sd2",
  "status": "COMPLETED",
  "creditsUsed": 200,
  "output": [
    {
      "url": "https://static.seegen.ai/videos/result.mp4",
      "width": 1280,
      "height": 720
    }
  ],
  "error": null,
  "createTime": 1711234567890,
  "completeTime": 1711234612345
}

credits Response

{
  "credits": 5000,
  "availableCredits": 4800
}

Error Handling

Pre-submit validation (400 with a code)

Seedance and Wan 3.0 requests are checked against SeeGen's product rules before any credits are charged. When a check fails, createTask returns { "message": "...", "code": "..." } with HTTP 400; Wan errors may also include a path. No task is created or charged.

Full Examples

Complete workflow: upload an asset, wait for review, create a task with the approved asset, and poll for the result.

const API_KEY = process.env.API_KEY;
const BASE = "https://seegen.ai/api/v1";
const headers = {
  "Authorization": `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Upload asset and wait for review
// (To upload a LOCAL file instead of a URL, POST multipart/form-data with a "file"
//  field — no Content-Type header, no "type" — see the Upload Asset section above.)
async function uploadAndWaitForAsset(url, type = "IMAGE") {
  const res = await fetch(`${BASE}/assets/upload`, {
    method: "POST",
    headers,
    body: JSON.stringify({ url, type }),
    signal: AbortSignal.timeout(120_000),
  });
  if (!res.ok) throw new Error(`Upload failed: ${(await res.json()).message}`);
  const asset = await res.json();
  console.log(`Asset uploaded: ${asset.assetId}, status: ${asset.status}`);

  // Poll until review completes
  const deadline = Date.now() + 15 * 60_000;
  while (true) {
    const statusRes = await fetch(
      `${BASE}/assets/status?assetId=${asset.assetId}`,
      { headers, signal: AbortSignal.timeout(30_000) }
    );
    if (!statusRes.ok) throw new Error(`Asset query failed (${statusRes.status}): ${await statusRes.text()}`);
    const status = await statusRes.json();
    if (status.status === "ACTIVE") {
      console.log(`Asset approved: asset://${status.volcAssetId}`);
      return status.volcAssetId;
    }
    if (status.status === "FAILED") {
      throw new Error(`Asset review failed: ${status.failReason}`);
    }
    if (Date.now() >= deadline) throw new Error(`Review pending: query assetId=${asset.assetId} later`);
    await new Promise((r) => setTimeout(r, 3000));
  }
}

// 2. Create a task
async function createTask(inputs, callBackUrl) {
  const res = await fetch(`${BASE}/jobs/createTask`, {
    method: "POST",
    headers,
    body: JSON.stringify({
      model: "sd2",
      inputs,
      ...(callBackUrl && { callBackUrl }),
    }),
    signal: AbortSignal.timeout(120_000),
  });
  if (!res.ok) throw new Error(`[${res.status}] ${(await res.json()).message}`);
  return res.json();
}

// 3. Poll until done
async function waitForResult(taskId, timeoutMs = 900000) {
  const start = Date.now();
  while (Date.now() - start < timeoutMs) {
    const res = await fetch(
      `${BASE}/jobs/queryTask?taskId=${taskId}`,
      { headers, signal: AbortSignal.timeout(30_000) }
    );
    if (!res.ok) throw new Error(`Query failed for ${taskId} (${res.status}): ${await res.text()}`);
    const result = await res.json();
    if (result.status === "COMPLETED") return result;
    if (result.status === "FAILED") throw new Error(result.error);
    await new Promise((r) => setTimeout(r, 5000));
  }
  throw new Error(`Still processing: query taskId=${taskId} later`);
}

// Full workflow: upload → review → generate → result
async function main() {
  // Upload image and wait for review
  const volcAssetId = await uploadAndWaitForAsset(
    "https://example.com/photo.jpg", "IMAGE"
  );

  // Create task with approved asset
  const { taskId } = await createTask({
    urls: [`asset://${volcAssetId}`],
    prompt: "The person slowly looks up and smiles",
    duration: "5s",
  });
  console.log(`Task: ${taskId}`);

  // Wait for video
  const result = await waitForResult(taskId);
  console.log(`Video: ${result.output[0].url}`);
}

main().catch(console.error);