Seedance 2.0 Fast · Reference to Video

Learn how to use Seedance 2.0 Fast · Reference to Video.

Developer API pricing

Provider: SeeAPI

USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.

480p: 16 credits/sec (≈ $0.06/sec, no video) | 10 credits/sec (≈ $0.037/sec, with video)

720p: 34 credits/sec (≈ $0.13/sec, no video) | 20 credits/sec (≈ $0.075/sec, with video)

Note: No video = unit price × output duration; with video = unit price × (output + reference video duration).

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task DetailsLearn how to query task status and retrieve generation results

Related Resources

Market Overview

Explore all available models

Credits & Billing

View credit balance, plans, and billing activity

Usage

Review API usage and credit consumption

Callbacks

Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.

Webhook flow

Callback URL per generation.

Webhook signing key

Request

POST/v1/generations

AuthorizationSend your API key in the Authorization header using the Bearer scheme.Authorization: Bearer ****************

Header Params

stringrequired

A unique key for this generation request. Reuse the same value only when retrying the identical request body.

max length: 255

Example:: order-20260818-001

Body Params

application/json

stringrequired

The public model ID documented on this page. Use seedance-2-fast for this Endpoint.

Allowed:seedance-2-fast

Default:: seedance-2-fast
Example:: seedance-2-fast

stringrequired

The public Endpoint ID for the selected model. Use the Endpoint whose input schema matches this request.

Allowed:reference-to-video

Default:: reference-to-video
Example:: reference-to-video

stringoptional

Optional public Provider ID. Omit this field to use the Endpoint's default Provider.

Allowed:seeapireplicate

Default:: seeapi
Example:: seeapi

objectrequired

Provider-specific input object. Its accepted fields and validation rules depend on the selected provider.

Provider parameters

SeeAPIseeapiDefault Provider

stringoptional

Describe what you want to generate. Include the subject, scene, style, motion, and any important details.

max length: 20000

array <uri>optional

Provide reference image URLs for subject, style, or composition guidance.

Provide at least one of reference_images, reference_video, or reference_audio.
reference_images accepts an array of up to 9 reachable image URLs.
Accepted formats: JPEG/JPG, PNG, WebP, BMP, TIFF, and GIF.
Each image must be smaller than 30 MB.
Width and height must each be greater than 300 and less than 6,000 pixels.
The width-to-height ratio must be greater than 0.4 and less than 2.5.

max items: 9

Example:: ["https://client.example.com/reference.png"]

array <uri>optional

Provide reference video URLs for motion or timing guidance.

reference_video accepts an array of up to 3 reachable video URLs.
Accepted formats: MP4 and MOV.
Each video must be 2–15 seconds.
Each video must use 480p or 720p resolution.
Width and height must each be 300–6,000 pixels.
The width-to-height ratio must be 0.4–2.5.
Total pixels per video must be 409,600–927,408.
Frame rate must be 24–60 FPS.
Maximum file size: 50 MB per video.
Combined duration of all reference videos must not exceed 15 seconds.

max items: 3

array <uri>optional

Provide reference audio URLs for speech, sound, or timing guidance.

reference_audio accepts an array of up to 3 reachable audio URLs.
Accepted formats: MP3 and WAV.
Each audio file must be 2–15 seconds.
Maximum file size: 15 MB per audio file.
Combined duration of all reference audio files must not exceed 15 seconds.

max items: 3

stringoptional

Choose the output aspect ratio for the SeeAPI Provider.

adaptive is a supported value.

Allowed:16:94:31:13:49:1621:9adaptive

Default:: 16:9

numberoptional

Choose a duration from 4 to 15 seconds.

min: 4max: 15

Default:: 5

stringoptional

Choose the output resolution. Higher resolutions may cost more credits.

Allowed:480p720p

Default:: 480p

booleanoptional

Enable to generate synchronized speech, ambient sound, and sound effects.

Default:: true

booleanoptional

Enable SeeAPI's NSFW checker.

Default:: true

Replicatereplicate

stringrequired

Describe what you want to generate. Include the subject, scene, style, motion, and any important details.

max length: 20000

Example:: A cinematic city at night

array <uri>optional

Provide up to 9 reference image URLs for subject, style, or composition guidance.

Provide at least one reference image or reference video.

max items: 9

array <uri>optional

Provide reference video URLs for motion or timing guidance.

Upload up to 3 videos.
Combined video duration must not exceed 15 seconds.

max items: 3

array <uri>optional

Provide reference audio URLs for speech, sound, or timing guidance.

Upload up to 3 audio files.
Combined audio duration must not exceed 15 seconds.
Reference audio requires at least one reference image or reference video.

max items: 3

stringoptional

Choose an output aspect ratio. Use adaptive to let Replicate choose based on the reference inputs.

Allowed:16:94:31:13:49:1621:99:21adaptive

Default:: adaptive

numberoptional

Choose a duration from 4 to 15 seconds.

min: 4max: 15

Default:: 5

stringoptional

Choose the output resolution. Higher resolutions may cost more credits.

Allowed:480p720p

Default:: 480p

booleanoptional

Enable to generate synchronized speech, ambient sound, and sound effects.

Default:: true

numberoptional

Use the same seed for similar results, or a different seed for new variations.

min: 0max: 999999

string <uri>optional

Optional absolute HTTPS URL that receives terminal generation updates. If omitted, query the task-details endpoint with the returned generation ID.

max length: 2048

Example:: https://client.example.com/webhooks/seeapi

Responses

202Generation accepted and processing

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: seedance-2-fast

stringrequired

Example:: reference-to-video

stringrequired

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 80

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: seedance-2-fast

stringrequired

Example:: reference-to-video

stringrequired

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 80

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable

Code Examples

Request

const response = await fetch("https://api.seeapi.com/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": "order-20260818-001",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "seedance-2-fast",
  "endpoint": "reference-to-video",
  "provider": "seeapi",
  "input": {
    "reference_images": [
      "https://client.example.com/reference.png"
    ],
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "resolution": "480p",
    "generate_audio": true,
    "nsfw_checker": true
  },
  "callback_url": "https://client.example.com/webhooks/seeapi"
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_xxx",
    "model": "seedance-2-fast",
    "endpoint": "reference-to-video",
    "provider": "seeapi",
    "status": "processing",
    "estimated_credits": 80,
    "consumed_credits": 0,
    "refunded_credits": 0,
    "created_at": "2026-08-18T10:00:00Z",
    "updated_at": "2026-08-18T10:00:00Z"
  },
  "idempotent": false
}

const response = await fetch("https://api.seeapi.com/v1/generations", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Idempotency-Key": "order-20260818-001", "Content-Type": "application/json" }, body: JSON.stringify({ "model": "seedance-2-fast", "endpoint": "reference-to-video", "provider": "seeapi", "input": { "reference_images": [ "https://client.example.com/reference.png" ], "aspect_ratio": "16:9", "duration_seconds": 5, "resolution": "480p", "generate_audio": true, "nsfw_checker": true }, "callback_url": "https://client.example.com/webhooks/seeapi" }) }); const result = await response.json();

{ "generation": { "id": "task_xxx", "model": "seedance-2-fast", "endpoint": "reference-to-video", "provider": "seeapi", "status": "processing", "estimated_credits": 80, "consumed_credits": 0, "refunded_credits": 0, "created_at": "2026-08-18T10:00:00Z", "updated_at": "2026-08-18T10:00:00Z" }, "idempotent": false }

Responses

202Generation accepted and processing

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: seedance-2-fast

stringrequired

Example:: reference-to-video

stringrequired

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 80

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

Example:: task_xxx

stringrequired

Example:: seedance-2-fast

stringrequired

Example:: reference-to-video

stringrequired

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 80

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable