Video tasks (Seedance)

Create a task

POST/v1/videos

curl https://www.link42.ai/v1/videos \
  -H "Authorization: Bearer $LINK42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-mini-260615",
    "content": [
      {"type": "text", "text": "First-person walk through Tokyo streets after rain, neon reflections"},
      {"type": "image_url", "image_url": {"url": "asset://1024"}, "role": "first_frame"}
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
  }'

{"id": "cgt-2026…", "status": "queued", "created_at": 1788300000}

• Only model, content and the video parameters (duration, frames, resolution, ratio, seed, camera_fixed, watermark, generate_audio, return_last_frame, draft, service_tier, omni_reference_task_type, output_format) are sent upstream; callback_url, client_request_id, mode and any other field stay with the platform. The same client_request_id with another body answers 409 idempotency_conflict.
• asset://<id> references only completed uploads owned by the caller. Depending on the upstream account it becomes an asset-library id, image data or a temporary signed link; another user's assets are refused.
• Token-priced video holds include both reference and output video. Without server-verified input duration, the hold reserves the model's total reference limit (15 seconds for 2.0, 30 for 2.5). Automatic output reserves the model maximum. Final settlement uses actual provider token usage, including its minimum-usage rules, and releases the difference.

Reference media and task modes

Text/frame generation and omni references are mutually exclusive. Reference creation, editing and extension use reference_image / reference_video / reference_audio, without first_frame / last_frame. For edit and extend prompts, describe the operation on Video 1 directly; calling it a reference may make the provider classify the task as reference creation.

The 2.0 series accepts up to 9 images, 3 videos and 3 audio clips, with videos and audio each totaling no more than 15 seconds; audio requires an image or video. 2.5 accepts 30 images, 10 videos and 10 audio clips, with videos and audio each totaling no more than 30 seconds, and allows audio-only input. Videos must be MP4/MOV up to 200 MiB; audio must be MP3/WAV up to 15 MiB.

• The website checks local clip durations before uploading. API URLs and library files without duration metadata receive final provider validation. A submitted task can still fail when its prompt disagrees with the declared task type; the platform releases the hold for a failed task.

Get a task

GET/v1/videos/{id}

curl https://www.link42.ai/v1/videos/cgt-2026… \
  -H "Authorization: Bearer $LINK42_API_KEY"

• Poll every 3–5 seconds, or use callback_url to receive the terminal-state notification.
• A task's time limits run from its submission upstream; time spent in the local queue does not count. A task the upstream has not finished 30 minutes after it was submitted is still polled and settled as it finishes upstream. One still unfinished after 6 hours is cancelled upstream and marked timeout: released when the upstream had not started it, charged its hold when the upstream may have run it.

List and cancel

GET /v1/videos?after=&limit=&status= lists tasks with cursor pagination; DELETE /v1/videos/{id} cancels a queued / running task (the held amount is released) or deletes a finished record. The upstream is asked first: a task it already finished successfully is settled as succeeded and the call answers 409 task_already_completed; one it failed ends as failed; while the task's upstream account cannot be reached nothing is cancelled and the hold stays (503 task_cancel_unavailable).

Pricing

tokens ≈ (input video seconds + output seconds) × width × height × fps ÷ 1024; 720p/24fps is roughly 21,600 tokens per second. Overseas Seedance 2.x uses the official per-million-output-token tier for the resolution and whether video input is present; final settlement follows upstream usage. Only successful generations are charged; a task given up after 6 hours while the upstream may still have run it is charged its hold. The account-model rate takes priority, then the account default, then the model default; rates do not stack.

The local queue

When the routed upstream account is already at its concurrency limit the task is not rejected: it waits in the platform's local queue with status local_queued, an id starting with lq-, and a queue_position field carrying its first-in-first-out rank. The estimated cost is already frozen at this point, but nothing has been sent upstream.

A background worker submits queued tasks in order as soon as the account frees a slot. On submission the task is re-keyed to the upstream task id and moves to queued; the original lq- id keeps resolving. If the submission response is lost, status becomes unknown and the hold stays in place while operators reconcile it; do not submit or cancel the job again. A task that waits in the local queue longer than its own maximum duration goes straight to timeout and its hold is released.

• A user may hold only so many tasks in local_queued / unknown / queued / running at once. Beyond that, creating a task answers 429 too_many_running_tasks; wait for one to finish or lower concurrency and retry.
• Cancelling a local_queued task releases the hold immediately. It never reached an upstream, so nothing is charged. An unknown task cannot be cancelled until its submission is reconciled.

Model reference

The first column is the catalogue id you put in `model`. Seedance 1.x and 2.x take their parameters differently: 1.x reads resolution, duration and camera motion from switches appended to the prompt, while 2.x uses structured request fields.

"Asset role" means the role field on an image_url / video_url / audio_url item inside content[]; only the roles listed are meaningful for that model.

• Whether a request counts as carrying video input follows one strict rule: content[] contains an item whose type is video_url, whose role is reference_video and whose url is non-empty. An image_url alone is not video input and lands in a different price tier.
• The tier is matched on the resolution reported in the result, falling back to the submitted resolution; when neither is available the base video rate applies.
• The four ep- ids above are legacy deployment examples. Domestic catalogue ids are seedance-2, seedance-2-0-fast, seedance-2-0-mini and seedance-2-5; overseas ids use the dreamina- aliases. The live marketplace or GET /v1/models determines what is published.