Seedance 2.0 API

Welcome to the Seedance 2.0 API.

Seedance 2.0 is built for cinematic video generation with flexible multimodal inputs and controllable workflows, including Text to Video, Image to Video, First & Last Frame to Video, and Multi-Ref / Omni Reference.

Currently available models:

Seedance2-Pro (high quality)
Seedance2-Fast (lower cost)

Base URL: https://seegen.ai/api/v1

Model: sd2 (Pro) or sd2-fast (Fast)

Feature	SeeGen	FAL
Availability	Live	Live
Human reference support	Yes (review-based)	No
API Stability	Production-ready	-
Concurrency	Auto-scalable (240+)	Limited (~10)
Latency	Low & stable	Variable
Resolutions	720P / 1080P / 2K / 4K	480P / 720P
SD2-Fast (720P)	$0.128/s (save 47.1%)	$0.2419/s
SD2-Pro (720P)	$0.160/s (save 47.1%)	$0.3024/s
SD2-Fast (720P, video input)	from $0.160/s (save up to 44.9%)	$0.2903/s
SD2-Pro (720P, video input)	from $0.200/s (save up to 44.9%)	$0.363/s
SD2-Pro (1080P)	$0.400/s	N/A
SD2-Pro (1080P, video input)	from $0.500/s	N/A

Note: Real human image and video assets require official review, usually completed within seconds. Once approved, they can be used directly as references. Without review, generation may fail.

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

Free credits on signup, no subscription required. Try it in the playground →

40% OFF

API Pack

$500$833

125,000 credits ($0.004/credit)

~781 5s videos

40% OFF

API-XL Pack

$2,000$3,332

500,000 credits ($0.004/credit)

~3,125 5s videos

Cost Calculation:

Let out = output_seconds and in = sum of ⌈duration⌉ of each input video (each rounded up, min out × 2/3).

	No video input	Include video input
sd2-pro: 720P	40 × out	30 × (out + in)
sd2-pro: 1080P	100 × out	75 × (out + in)
sd2-pro: 2K	(40 + 30) × out	30 × (out + in) + 30 × out
sd2-pro: 4K	(40 + 40) × out	30 × (out + in) + 40 × out
sd2-fast: 720P	32 × out	24 × (out + in)
sd2-fast: 1080P	(32 + 20) × out	24 × (out + in) + 20 × out
sd2-fast: 2K	(32 + 30) × out	24 × (out + in) + 30 × out
sd2-fast: 4K	(32 + 40) × out	24 × (out + in) + 40 × out

Note: sd2-pro 1080P is native official output at a higher cost; sd2-fast 1080P and 2K/4K in both modes are upscaled by SeeGen AI.

gpt-image-2 — credits per image

Resolution	Medium quality	High quality
1k	15	70
2k (default)	35	125
4k	60	230

Each task produces 1 image. Submit N tasks for N variants. Failed tasks refund credits automatically.

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

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

Important: Your API key is shown only once at creation. Store it securely. You can create up to 10 API keys per account.

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

# 1. Create a text-to-video task
TASK_ID=$(curl -s -X POST \
  -H "Authorization: Bearer $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 | jq -r '.taskId')

echo "Task created: $TASK_ID"

# 2. Poll for result
while true; do
  RESULT=$(curl -s -H "Authorization: Bearer $API_KEY" \
    "https://seegen.ai/api/v1/jobs/queryTask?taskId=$TASK_ID")
  STATUS=$(echo $RESULT | jq -r '.status')
  echo "Status: $STATUS"
  if [ "$STATUS" = "COMPLETED" ] || [ "$STATUS" = "FAILED" ]; then
    echo $RESULT | jq .
    break
  fi
  sleep 5
done

POST/api/v1/jobs/createTask

Create a new video generation task

GET/api/v1/jobs/queryTask

Query task status and result

GET/api/v1/account/credits

Check your credits balance

POST/api/v1/assets/upload

Upload an asset (image/video/audio) for review

GET/api/v1/assets/status

Query asset review status

GET/api/v1/assets/list

List your uploaded assets

POST/api/v1/upscale/create

Submit a standalone video upscale task (1080p / 2K / 4K)

GET/api/v1/upscale/query

Poll a standalone upscale task's status and result

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

Parameter	Type	Required	Description
prompt	string	Yes	Text description of the video to generate
duration	string	No	Video length: "4s" to "15s" (default: "5s")
resolution	string	No	Aspect ratio via resolution. Options: 720x720, 720x960, 960x720, 1280x720, 720x1280, 1280x540
upscaleResolution	string	No	Upscale output via WaveSpeed: "1080p" / "2k" / "4k". Use "1080p" for sd2-fast to get 1080P (fast has no native 1080P).

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"],  // or "asset://asset-20260326-abc123"
      "prompt": "The woman slowly turns her head and smiles",
      "duration": "5s"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Parameter	Type	Required	Description
urls	string[]	Yes	Array with one image URL (the source frame). Supports both HTTP URLs and asset references (e.g. "asset://asset-20260326-abc123")
prompt	string	No	Text description of the desired motion
duration	string	No	Video length: "4s" to "15s" (default: "5s")
upscaleResolution	string	No	Upscale output via WaveSpeed: "1080p" / "2k" / "4k". Use "1080p" for sd2-fast to get 1080P (fast has no native 1080P).

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

Parameter	Type	Required	Description
urls	string[]	Yes	Array with exactly 2 image URLs: [first_frame, last_frame]. Supports both HTTP URLs and asset references (e.g. "asset://asset-20260326-abc123")
videoInputMode	string	Yes	Must be "keyframe"
prompt	string	No	Text description guiding the transition
duration	string	No	Video length: "4s" to "15s" (default: "5s")
upscaleResolution	string	No	Upscale output via WaveSpeed: "1080p" / "2k" / "4k". Use "1080p" for sd2-fast to get 1080P (fast has no native 1080P).

Use multiple reference images, videos, and audio files to guide generation. Uses videoInputMode: "reference".

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": ["https://example.com/motion-ref.mp4"],
      "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

Parameter	Type	Required	Description
urls	string[]	No	Reference image URLs (max 9). Supports both HTTP URLs and asset references (e.g. "asset://asset-20260326-abc123")
videoUrls	string[]	No	Reference video asset:// URIs (max 3, each ≤15s). Must be uploaded via /api/v1/assets/upload first — external URLs are rejected.
audioUrls	string[]	No	Reference audio URLs (max 3, each ≤15s). Cannot be the only reference — requires at least one image or video.
videoInputMode	string	Yes	Must be "reference"
prompt	string	No	Text description
duration	string	No	Video length: "4s" to "15s" (default: "5s")
resolution	string	Yes	Required for reference mode. Options: 720x720, 720x960, 960x720, 1280x720, 720x1280, 1280x540
upscaleResolution	string	No	Upscale output via WaveSpeed: "1080p" / "2k" / "4k". Use "1080p" for sd2-fast to get 1080P (fast has no native 1080P).

Reference Constraints

Max 9 images, 3 videos, 3 audio files
Max 12 total files across all types
Each video/audio must be ≤ 15 seconds
Images must be at least 400px on the shortest side

An alternative video generation model from Alibaba DashScope. Supports three modes: text-to-video, first-frame image-to-video, and reference-to-video (1–9 reference images fused per prompt; refer to subjects with character1, character2, … in the prompt). HappyHorse 1.0 does not support last-frame, reference video, or reference audio. Model name: happyhorse.

No asset review required — you can use public HTTPS image URLs directly, or pass asset:// references from the asset library (resolved back to the original R2 URL automatically).

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse",
    "inputs": {
      "prompt": "A panda DJ at a beach party, smoky sunset",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse",
    "inputs": {
      "urls": ["https://example.com/panda.jpg"],
      "prompt": "The panda blinks and smiles",
      "duration": "5s",
      "outputResolution": "1080p"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Pass videoWorkflowTab: "multi-reference" with 1–9 reference image URLs to fuse multiple subjects into a single output. Reference each image in the prompt with character1, character2, … (matching the order of urls). Aspect ratio is controlled by the ratio field (no first frame to drive it from).

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse",
    "inputs": {
      "videoWorkflowTab": "multi-reference",
      "urls": [
        "https://example.com/character.jpg",
        "https://example.com/folding-fan.jpg",
        "https://example.com/earrings.jpg"
      ],
      "prompt": "A woman in red character1 opening folding fan character2, with tassel earrings character3 swinging",
      "duration": "5s",
      "outputResolution": "720p",
      "ratio": "16:9"
    }
  }' \
  https://seegen.ai/api/v1/jobs/createTask

Parameter	Type	Required	Description
prompt	string	No	Text description. Required for text-to-video and reference-to-video; optional for image-to-video. Max 5000 non-CJK chars or 2500 CJK chars (upstream auto-truncates beyond). In r2v use character1/character2/… to refer to the N-th reference image.
urls	string[]	No	t2v: omit. i2v: exactly 1 URL (used as the first frame). r2v: 1–9 URLs. Supports public HTTPS URLs and asset references (e.g. "asset://asset-20260326-abc123").
videoWorkflowTab	string	No	Set to "multi-reference" to enable reference-to-video mode (must be combined with 1+ urls). Omit for text-to-video / image-to-video.
duration	string	No	Integer seconds, "3" to "15" (default "5").
outputResolution	string	No	"720p" (default) or "1080p".
ratio	string	No	"16:9" / "9:16" / "1:1" / "4:3" / "3:4". Used for text-to-video and reference-to-video — image-to-video aspect is inferred from the first frame.
seed	int	No	0 to 2147483647. Leave blank for a random seed.

Image Requirements (i2v / r2v)

Shortest side ≥ 300px
Aspect ratio between 1:2.5 and 2.5:1
Formats: JPEG, JPG, PNG, BMP, WEBP
Max file size 10MB per image (r2v: each of the 1–9 inputs)

Pricing

720P: 32 credits/sec (5s = 160, 15s = 480)
1080P: 60 credits/sec (5s = 300, 15s = 900)
r2v / i2v / t2v share the same per-second rate (reference images are not billed)

Complete reference of all inputs parameters for the sd2 model.

Parameter	Type	Required	Description
prompt	string	No	Text description (required for text-to-video, optional for other modes)
urls	string[]	No	Image URLs. Supports both HTTP URLs and asset references (e.g. "asset://asset-20260326-abc123"). Maps to uploadedUrls internally.
videoUrls	string[]	No	Video reference asset:// URIs (reference mode only). Must be uploaded via /api/v1/assets/upload first — external URLs are rejected.
audioUrls	string[]	No	Audio reference URLs (reference mode only). Cannot be the only reference — requires at least one image or video.
duration	string	No	"4s" to "15s". Default: "5s"
resolution	string	No	Aspect ratio (pixel string): 720x720 \| 720x960 \| 960x720 \| 1280x720 \| 720x1280 \| 1280x540
outputResolution	string	No	ARK-native output tier: "720p" (default) or "1080p". Only sd2 supports 1080p natively — for sd2-fast use upscaleResolution instead.
videoInputMode	string	No	"keyframe" (default) or "reference"
upscaleResolution	string	No	WaveSpeed post-generation upscale: "1080p" / "2k" / "4k". Use "1080p" for sd2-fast to reach 1080P output.

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

Image generation models are independent from video — they take a prompt (and optionally reference images) and return a single image per task. Each request is billed per image based on resolution and quality, with credits refunded automatically on failure.

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.

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

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

Parameter	Type	Required	Description
prompt	string	Yes	Text description of the image to generate, or the edit to apply when urls is provided.
urls	string[]	No	Reference image URLs for image-to-image (edit) mode (1–10 images). Omit for text-to-image. Public HTTPS URLs accepted.
quality	string	No	"medium" / "high". Default: "medium". Credits scale by tier (see Pricing).
resolution	string	No	"1k" / "2k" / "4k". Default: "2k". Credits scale by tier (see Pricing).
aspectRatio	string	No	"1:1" / "16:9" / "9:16" / "4:3" / "3:4". Default: "1:1".
outputFormat	string	No	"png" / "jpeg" / "webp". Default: "png".

Input Image Requirements (image-to-image mode)

Up to 10 reference images per task
Max file size 50 MB per image
Shortest side ≥ 256px
Aspect ratio between 1:3 and 3:1
Formats: JPEG, JPG, PNG, WEBP

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

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

Submit a publicly accessible URL for review. The asset will be processed and reviewed automatically.

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

Parameter	Type	Required	Description
url	string	Yes	Publicly accessible URL of the file to upload
type	string	Yes	"IMAGE", "AUDIO", or "VIDEO"
name	string	No	Asset name (max 64 characters)

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

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"

Asset Status Values

PROCESSING — under review, not yet usable
ACTIVE — review passed, ready for use in tasks
FAILED — review failed, check failReason

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"

Parameter	Type	Required	Description
type	string	No	Filter by type: "IMAGE", "AUDIO", or "VIDEO"
status	string	No	Filter by status: "NONE", "PROCESSING", "ACTIVE", or "FAILED"
cursor	number	No	Cursor for pagination (use nextCursor from previous response)
limit	number	No	Items per page, 1-50 (default: 20)

{
  "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
}

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"
  }
}

POST /api/v1/upscale/create

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

Parameter	Type	Required	Description
source.type	string	Yes	"url" (public https) or "uploadId" (R2-hosted asset)
source.url	string	No	Required when type="url". Must be https. http and private/internal IPs are rejected.
source.r2Url	string	No	Required when type="uploadId". The R2 URL returned by /api/v1/assets/upload.
targetResolution	string	Yes	"1080p", "2k", or "4k". Must be higher than the source resolution.
callBackUrl	string	No	Webhook URL invoked once on terminal state (completed or failed).

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

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"

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

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

Limits

Source: https URL or your previously uploaded R2 URL
Duration up to 600 s (clips under 5 s are billed as 5 s)
File size ≤ 200 MB
Format: MP4 / MOV / WebM
Source resolution must be lower than target

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

Code	Meaning
INVALID_URL	URL is malformed or not https
URL_NOT_REACHABLE	Couldn't fetch the URL — check it's public and reachable
UNSUPPORTED_MEDIA_TYPE	File is not a video, or not in MP4 / MOV / WebM
FILE_TOO_LARGE	Source exceeds 200 MB
DURATION_EXCEEDS_LIMIT	Source longer than 600 s
SOURCE_RESOLUTION_TOO_HIGH	Source already at or above target — pick a higher target
INSUFFICIENT_CREDITS	Not enough credits — top up and retry

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

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

// POST to your callBackUrl
{
  "taskId": "task_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
}

Retry Policy: If your endpoint returns a non-2xx status, we retry up to 3 times with increasing delays (1s, 5s, 30s).

// 200 OK
{ "taskId": "task_abc123" }

{
  "taskId": "task_abc123",
  "model": "sd2",
  "status": "COMPLETED",     // "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED"
  "creditsUsed": 200,
  "output": [                // null when status is not "COMPLETED"
    {
      "url": "https://static.seegen.ai/videos/result.mp4",
      "width": 1280,
      "height": 720
    }
  ],
  "error": null,             // error message when status is "FAILED"
  "createTime": 1711234567890,
  "completeTime": 1711234612345
}

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

Status Code	Meaning	Action
400	Invalid parameters	Check the error message and fix your request
401	Invalid or missing API key	Check your Authorization header format
402	Insufficient credits	Purchase more credits at seegen.ai
403	Access denied	You can only query your own tasks
404	Task not found	Verify the taskId is correct
429	Concurrency limit (3 tasks)	Wait for existing tasks to complete
500	Internal server error	Retry after a few seconds

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
async function uploadAndWaitForAsset(url, type = "IMAGE") {
  const res = await fetch(`${BASE}/assets/upload`, {
    method: "POST",
    headers,
    body: JSON.stringify({ url, type }),
  });
  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
  while (true) {
    const statusRes = await fetch(
      `${BASE}/assets/status?assetId=${asset.assetId}`,
      { headers }
    );
    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}`);
    }
    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 }),
    }),
  });
  if (!res.ok) throw new Error(`[${res.status}] ${(await res.json()).message}`);
  return res.json();
}

// 3. Poll until done
async function waitForResult(taskId, timeoutMs = 300000) {
  const start = Date.now();
  while (Date.now() - start < timeoutMs) {
    const res = await fetch(
      `${BASE}/jobs/queryTask?taskId=${taskId}`,
      { headers }
    );
    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("Timeout waiting for task");
}

// 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);

Need help? Join our Discord or contact us

Seedance 2.0 API

Overview

Why SeeGen AI?

More Reasons to Choose SeeGen AI:

Pricing

API Pack

API-XL Pack

Authentication

Quick Start

Endpoints

Text to Video

Image to Video

First & Last Frame

Multi-Reference

HappyHorse 1.0 (Alibaba)

Text-to-Video

Image-to-Video (First Frame)

Reference-to-Video (1–9 Reference Images)

Parameters Reference

Image Generation

GPT Image 2

Text-to-Image

Image-to-Image (Editing)

Assets

Upload Asset

Upload Response

Query Asset Status

List Assets

List Response

Using Assets in Tasks

Video Upscaler

Create Task

Create Response

Query Status

Completed Response

Failed Response

Error Codes

Webhook Callback

Callback Payload

Response Format

createTask Response

queryTask Response

credits Response

Error Handling

Full Examples