seedance-2.5

Seedance 2.5 uses one creation endpoint for five video capabilities. Select a tab for the request shape you need. Use the returned task ID with the query tab to retrieve the result.

Create task

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "callback_url": "https://example.com/webhooks/seedance",
    "content": [
      {
        "type": "text",
        "text": "A 20-second cinematic tracking shot through a miniature steampunk city at golden hour"
      }
    ],
    "generate_audio": true,
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 20,
    "output_format": "mp4"
  }'

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Data exchange format.

Request body

string

required

AnyFast model ID. Use seedance-2.5. For specific-content requests, select the Direct resource group and use seedance-2.5-nsfw.

object[]

required

Input content. Text-to-video requires at least one text item.

string

required

Use text for the prompt item.

string

required

Prompt describing the subject, action, scene, visual style, camera movement, and audio intent.

boolean

default:true

Generate synchronized dialogue, sound effects, and background audio.

string

default:"720p"

Output resolution. Supported values: 480p, 720p, 1080p. The 1080p option uses 10-bit H.265/HEVC output.

string

default:"adaptive"

Output ratio. Supported values: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive.

integer

default:-1

Output duration. Use -1 for an automatically selected duration or choose an integer from 4 through 30.

object[]

Optional text-to-video tools. Set tools[].type to web_search to let the model search current information before generation.

Create response

200

{
  "id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1786084139
}

string

Task ID used to query the result.

string

Task ID, identical to id.

string

Returned object type. For this endpoint, video.

string

AnyFast model ID used by the task.

string

Initial task status. A newly accepted task is queued.

integer

Initial task progress percentage.

integer

Creation time as a Unix timestamp in seconds.

Create task

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "reference",
    "content": [
      {"type":"text","text":"@image1 performs the motion from @video1, paced to @audio1"},
      {"type":"image_url","image_url":{"url":"https://example.com/character.jpg"},"role":"reference_image"},
      {"type":"video_url","video_url":{"url":"https://example.com/motion.mp4"},"role":"reference_video"},
      {"type":"audio_url","audio_url":{"url":"https://example.com/music.mp3"},"role":"reference_audio"}
    ],
    "generate_audio": true,
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 15,
    "output_format": "mp4"
  }'

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Data exchange format.

Request body

string

required

AnyFast model ID. Supported values: seedance-2.5, seedance-2.5-nsfw.

string

Reference task type. Supported values: auto, reference, edit, extend. Use reference for this capability; auto lets the model infer the workflow from the media and prompt.

object[]

required

Text and reference media. The prompt is optional. Use @image1, @video1, and @audio1 to refer to media by type and order. Supports up to 30 images, 10 videos, and 10 audio clips.

string

required

Content type: text, image_url, video_url, or audio_url.

string

Prompt text for a text item.

string

Public image URL, Base64 data URI, or asset://<ASSET_ID> reference.

string

Public video URL or asset://<ASSET_ID> reference.

string

Public audio URL, Base64 data URI, or asset://<ASSET_ID> reference.

string

required

Media role: reference_image, reference_video, or reference_audio.

boolean

default:true

Generate synchronized audio.

string

default:"720p"

Supported values: 480p, 720p, 1080p.

string

default:"adaptive"

Supported values: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive.

integer

default:-1

Use -1 or an integer from 4 through 30.

Create response

200

{
  "id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1786084139
}

string

Task ID used to query the result.

string

Task ID, identical to id.

string

Returned object type.

string

AnyFast model ID.

string

Initial task status.

integer

Initial task progress percentage.

integer

Creation Unix timestamp in seconds.

Create task

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"Edit @video1: remove every background pedestrian while preserving the main subject"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "generate_audio": true,
    "resolution": "1080p",
    "ratio": "adaptive",
    "duration": -1,
    "output_format": "mov"
  }'

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Data exchange format.

Request body

string

required

Supported values: seedance-2.5, seedance-2.5-nsfw.

string

Reference task type. Use edit for video editing. Supported values: auto, reference, edit, extend.

object[]

required

Editing instruction and source media.

string

required

Use text for the instruction and video_url for the source.

string

required

Editing instruction. Refer to the source as @video1.

string

required

Public source-video URL or asset://<ASSET_ID> reference.

string

required

Use reference_video for the source video.

boolean

default:true

Generate synchronized audio.

string

default:"720p"

Supported values: 480p, 720p, 1080p.

string

default:"adaptive"

required

Video editing only supports adaptive; the output follows the source ratio.

integer

default:-1

required

Video editing only supports -1; the output stays close to the source duration and can be up to 0.4 seconds shorter.

Create response

200

{
  "id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1786084139
}

string

Task ID used to query the result.

string

Task ID, identical to id.

string

Returned object type.

string

AnyFast model ID.

string

Initial task status.

integer

Initial task progress percentage.

integer

Creation Unix timestamp in seconds.

Create task

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "extend",
    "content": [
      {"type":"text","text":"Extend @video1: the camera passes through the open window into a quiet gallery"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}
    ],
    "generate_audio": true,
    "resolution": "1080p",
    "ratio": "adaptive",
    "duration": 11,
    "output_format": "mov"
  }'

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Data exchange format.

Request body

string

required

Supported values: seedance-2.5, seedance-2.5-nsfw.

string

Reference task type. Use extend for video extension. Supported values: auto, reference, edit, extend.

object[]

required

Extension instruction and reference media.

string

required

Use text for the instruction and video_url for video inputs.

string

required

Extension instruction. Identify the video to extend with @video1.

string

required

Public video URL or asset://<ASSET_ID> reference.

string

required

Use reference_video for each video input.

boolean

default:true

Generate synchronized audio.

string

default:"720p"

Supported values: 480p, 720p, 1080p.

string

default:"adaptive"

required

Video extension only supports adaptive; the output follows the selected source ratio.

integer

default:-1

Use -1 or an integer from 4 through 30. An explicit duration must be longer than the source video.

Create response

200

{
  "id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1786084139
}

string

Task ID used to query the result.

string

Task ID, identical to id.

string

Returned object type.

string

AnyFast model ID.

string

Initial task status.

integer

Initial task progress percentage.

integer

Creation Unix timestamp in seconds.

Create task

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "content": [
      {"type":"text","text":"The subject smiles at the camera while it makes a smooth 360-degree orbit"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "generate_audio": true,
    "resolution": "1080p",
    "ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4"
  }'

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Data exchange format.

Request body

string

required

Supported values: seedance-2.5, seedance-2.5-nsfw.

object[]

required

Prompt and one first frame, optionally followed by one last frame.

string

required

Use text for the prompt and image_url for each frame.

string

Prompt describing motion and the transition between frames.

string

required

Public image URL, Base64 data URI, or asset://<ASSET_ID> reference.

string

required

Use first_frame for the first image and last_frame for the optional second image.

boolean

default:true

Generate synchronized audio.

string

default:"720p"

Supported values: 480p, 720p, 1080p.

string

default:"adaptive"

required

Frame-guided generation only supports adaptive; the output follows the first frame.

integer

default:-1

Use -1 or an integer from 4 through 30.

Create response

200

{
  "id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1786084139
}

string

Task ID used to query the result.

string

Task ID, identical to id.

string

Returned object type.

string

AnyFast model ID.

string

Initial task status.

integer

Initial task progress percentage.

integer

Creation Unix timestamp in seconds.

Query task by ID

GET /v1/video/generations/{id}

cURL

curl --request GET \
  --url https://www.anyfast.ai/v1/video/generations/asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM \
  --header 'Authorization: Bearer YOUR_API_KEY'

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

Path parameters

string

required

Task ID returned by the create request.

Task result fields

200

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
    "action": "omniGenerate",
    "status": "SUCCESS",
    "result_url": "https://example.com/generated-video.mp4",
    "submit_time": 1786084139,
    "start_time": 1786084145,
    "finish_time": 1786084265,
    "progress": "100%",
    "request_id": "20260807143000000000000example",
    "data": {
      "content": {
        "video_url": "https://example.com/generated-video.mp4"
      },
      "duration": 20,
      "generate_audio": true,
      "ratio": "16:9",
      "resolution": "1080p",
      "output_format": "mp4",
      "status": "succeeded"
    }
  }
}

string

Response code.

string

Response message.

string

Platform task ID.

string

Generation action, such as generate, referenceGenerate, or omniGenerate.

string

NOT_START, QUEUED, or IN_PROGRESS means keep polling. On SUCCESS, read result_url. On FAILURE, read fail_reason.

string

Generated video URL. It remains available for 24 hours and allows up to 100 downloads.

string

Failure reason when status is FAILURE.

integer

Task submission Unix timestamp in seconds.

integer

Task start Unix timestamp in seconds.

integer

Task completion Unix timestamp in seconds.

string

Task progress percentage.

string

Request trace ID.

object

Provider result metadata.

string

Generated video URL in the provider result.

number

Generated duration in seconds.

boolean

Whether the result contains generated audio.

string

Generated video aspect ratio.

string

Generated video resolution.

string

Generated video container format: mp4 or mov.

string

Provider task status.

Shared optional controls

These fields apply to every creation capability.

string

Public HTTP(S) endpoint that receives a POST callback when the task reaches SUCCESS or FAILURE. The callback body matches the task result returned by GET /v1/video/generations/{id}.

Callback payload examples

Success
Failure

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_example_success",
    "action": "textGenerate",
    "status": "SUCCESS",
    "result_url": "https://example.com/generated-video.mp4",
    "submit_time": 1789573802,
    "start_time": 1789573812,
    "finish_time": 1789573951,
    "progress": "100%",
    "request_id": "20260916155001example",
    "data": {
      "id": "cgt-20260916235002-example",
      "model": "doubao-seedance-2-5-260628",
      "status": "succeeded",
      "content": {
        "video_url": "https://example.com/generated-video.mp4"
      },
      "duration": 4,
      "resolution": "480p",
      "ratio": "16:9",
      "generate_audio": true,
      "output_format": "mp4"
    }
  }
}

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_example_failure",
    "action": "textGenerate",
    "status": "FAILURE",
    "fail_reason": "task failed",
    "submit_time": 1789574546,
    "start_time": 1789574551,
    "finish_time": 1789574663,
    "progress": "100%",
    "request_id": "20260916160226example",
    "data": {
      "id": "cgt-20260917000226-example",
      "model": "doubao-seedance-2-5-260628",
      "status": "failed",
      "error": {
        "code": "OutputVideoSensitiveContentDetected.PolicyViolation",
        "message": "The output video may be related to copyright restrictions."
      }
    }
  }
}

integer

default:172800

Maximum queued or running lifetime in seconds before the task expires.

integer

default:0

Task execution priority.

string

Stable end-user identifier used for safety tracing.

integer

default:-1

Random seed. Use -1 to select a random seed.

string

default:"default"

Task service tier.

string

default:"mp4"

Output video container format. Supported values: mp4, mov. Use the exact field name output_format; out_format is not supported and may be ignored.

boolean

default:false

Add an AI-generated watermark to the lower-right corner.

boolean

default:false

Return the generated video’s final frame as an image.

Input limits

Images

Accepted inputs: public URL, Base64 data URI, or asset ID.
Formats: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF.
Width-to-height ratio: 0.4–2.5. Each side: 300–6,000 px. Each image must be smaller than 30 MB.
Supply one image for first-frame generation, two for first-and-last-frame generation, or 1–30 reference images.

Videos

Accepted inputs: public URL or asset ID. Containers: MP4 or MOV. Video codecs: H.264/AVC or H.265/HEVC. Audio codecs: AAC, MP3, and PCM for MOV.
Input resolution: 480p or 720p. Frame rate: 24–60 FPS. Width-to-height ratio: 0.4–2.5. Each side: 300–6,000 px. Pixels per frame: 407,696–8,295,044. Maximum file size: 200 MB.
Each video must be 2–30 seconds for non-editing tasks and 4–30 seconds for editing. Supply up to 10 reference videos with no more than 30 seconds total.

Audio

Accepted inputs: public URL, Base64 data URI, or asset ID. Formats: WAV or MP3.
Each clip must be 2–30 seconds and no larger than 15 MB. Supply up to 10 clips with no more than 30 seconds total.

The complete request body must not exceed 64 MB. Avoid Base64 for large files. Task records remain queryable for 7 days; generated video URLs remain available for 24 hours and allow up to 100 downloads.

Sources: Seedance 2.5 tutorial and create video generation task API.

Overview

Native Compatible Endpoints

Model APIs

Create task

Request headers

Request body

Create response

Create task

Request headers

Request body

Create response

Create task

Request headers

Request body

Create response

Create task

Request headers

Request body

Create response

Create task

Request headers

Request body

Create response

Query task by ID

Request headers

Path parameters

Task result fields

Shared optional controls

Callback payload examples

Input limits

Images

Videos

Audio

​Create task

​Request headers

​Request body

​Create response

​Create task

​Request headers

​Request body

​Create response

​Create task

​Request headers

​Request body

​Create response

​Create task

​Request headers

​Request body

​Create response

​Create task

​Request headers

​Request body

​Create response

​Query task by ID

​Request headers

​Path parameters

​Task result fields

​Shared optional controls

​Callback payload examples

​Input limits

​Images

​Videos

​Audio

Create task

Request headers

Request body

Create response

Create task

Request headers

Request body

Create response

Create task

Request headers

Request body

Create response

Create task

Request headers

Request body

Create response

Create task

Request headers

Request body

Create response

Query task by ID

Request headers

Path parameters

Task result fields

Shared optional controls

Callback payload examples

Input limits

Images

Videos

Audio