# Bytedance Seedance 2.5
## OpenAPI Specification
```yaml
openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/api/v1/jobs/createTask:
post:
summary: Bytedance Seedance 2.5
deprecated: false
description: >
## Query Task Status
After submitting a task, use the unified query endpoint to check
progress and retrieve results:
Learn how to query task status and retrieve generation results
::: tip[]
In production environments, it is recommended to use the callBackUrl
parameter to receive automatic notifications upon completion, rather
than polling the status API.
:::
> **Note**
>
> * **Image-to-Video (First Frame)**, **Image-to-Video (First & Last
Frames)**, and **Multimodal Reference-to-Video** (including reference
images, videos, and audio) are three mutually exclusive scenarios and
**cannot be used simultaneously**.
> * Multimodal Reference-to-Video can indirectly achieve a "First/Last
Frame + Multimodal Reference" effect by specifying reference images as
the first or last frame via prompts. If you need to strictly guarantee
that the first and last frames are identical to the specified images,
**prioritize using Image-to-Video (First & Last Frames)**
## Key Features
Generate videos directly from text descriptions without input images
First frame, or first and last frames
Up to 30 images, 10 videos and 10 audio clips
Optional audio generation for enhanced video content
:::tip
With reference video(s), billing uses a lower per-second price × (total
reference-video duration + output duration); reference images and
reference audio do not add billable seconds. With duration = -1, billing
follows the duration actually generated. For current prices, see
[kie.ai/pricing](https://kie.ai/pricing).
:::
## Related Resources
Explore all available models
Check credits and account usage
operationId: bytedance-seedance-2-5
tags:
- docs/en/Market/Video Models/Bytedance
parameters: []
requestBody:
content:
application/json:
schema:
type: object
required:
- model
- input
properties:
model:
type: string
description: |-
The model name to use for generation. Required field.
- Must be `bytedance/seedance-2-5` for this endpoint
enum:
- bytedance/seedance-2-5
default: bytedance/seedance-2-5
x-apidog-enum:
- value: bytedance/seedance-2-5
name: ''
description: ''
examples:
- bytedance/seedance-2-5
callBackUrl:
type: string
format: uri
description: >-
The URL to receive generation task completion updates.
Optional but recommended for production use.
- System will POST task status and results to this URL when
generation completes
- Callback includes generated content URLs and task
information
- Your callback endpoint should accept POST requests with
JSON payload containing results
- Alternatively, use the Get Task Details endpoint to poll
task status
- To ensure callback security, see [Webhook Verification
Guide](/common-api/webhook-verification) for signature
verification implementation
examples:
- https://your-domain.com/api/callback
input:
type: object
description: Input parameters for the generation task
properties:
prompt:
type: string
description: >-
The text prompt used to generate the video.. ( Max
length: 20480 characters)
maxLength: 20480
examples:
- >-
A serene beach at sunset with waves gently crashing on
the shore, palm trees swaying in the breeze, and
seagulls flying across the orange sky
first_frame_url:
type: string
description: >-
First frame image url or asset://{assetId}
(for example: asset://asset-20260404242101-76djj)
Cannot be used simultaneously with reference_image_urls,
reference_video_urls, or reference_audio_urls.
last_frame_url:
type: string
description: >-
End frame image url or asset://{assetId}
(for example: asset://asset-20260404242101-76djj)
last_frame_url cannot be passed alone; first_frame_url
must be provided together with it.
reference_image_urls:
type: array
items:
type: string
format: uri
description: >-
Enter a list of image URLs or asset://{assetId} (for
example: asset://asset-20260404242101-76djj).
Single image requirements:
Format: jpeg, png, webp.
Aspect ratio (width/height): (0.4, 2.5)
Width and height (px): (300, 6000)
Size: Single image less than 30 MB.
Up to 30 images.
Mutually exclusive with the first/last-frame scenario;
maxItems: 30
examples:
- - https://example.com/your-image.png
reference_video_urls:
type: array
items:
type: string
format: uri
description: >-
Enter a list of video URLs or asset://{assetId} (for
example: asset://asset-20260404242101-76djj) .
Single video requirements:
Video format: mp4, mov, mkv.
Resolution: 480p, 720p
Dimensions:
Aspect ratio (width/height): [0.4, 2.5]
Width/height (px): [300, 6000]
Total pixels: [640×640=409600, 834×1112=927408], i.e.,
the product of width and height must meet the range
requirement of [409600, 927408].
Size: Single video not exceeding 200 MB.
Frame rate (FPS): [24, 60]
Single video duration: [2, 30] seconds;
Mutually exclusive with the first/last-frame scenario;
Total duration of reference videos must not exceed 30
seconds.
maxItems: 10
reference_audio_urls:
type: array
items:
type: string
format: uri
description: >-
Enter a list of audio URLs or asset://{assetId} (for
example: asset://asset-20260404242101-76djj) .
Single audio requirements:
Format: wav, mp3, aac, ogg
Size: Single audio file size not exceeding 15 MB.
Single audio duration: [2, 30] seconds; mutually
exclusive with first/last frames; total duration of
reference audio must not exceed 30 seconds.
maxItems: 10
return_last_frame:
type: boolean
description: >-
Whether to also return the last frame of the generated
video as a JPEG (in resultJson.lastFrameUrl). Default
false.
default: false
generate_audio:
description: >-
Whether to generate audio synchronized with the video.
Default: true.
type: boolean
default: true
examples:
- false
resolution:
type: string
description: >-
Video resolution - 480p for faster generation, 720p for
balance.
enum:
- 480p
- 720p
- 1080p
default: 720p
examples:
- 720p
x-apidog-enum:
- value: 480p
name: ''
description: ''
- value: 720p
name: ''
description: ''
- value: 1080p
name: ''
description: ''
aspect_ratio:
type: string
description: 'Video aspect ratio configuration. '
enum:
- '1:1'
- '4:3'
- '3:4'
- '16:9'
- '9:16'
- '21:9'
- adaptive
default: adaptive
x-apidog-enum:
- value: '1:1'
name: ''
description: ''
- value: '4:3'
name: ''
description: ''
- value: '3:4'
name: ''
description: ''
- value: '16:9'
name: ''
description: ''
- value: '9:16'
name: ''
description: ''
- value: '21:9'
name: ''
description: ''
- value: adaptive
name: ''
description: ''
examples:
- adaptive
duration:
type: integer
description: |-
Video duration in 4-30 seconds.
Special values -1:
Pass -1 for automatic duration selection — the model picks a suitable duration itself (for video-editing tasks, it matches the input video's length; for other task types, it selects within the valid range), instead of you specifying an exact value.
default: 5
examples:
- 5
output_format:
type: string
description: Video output format.
enum:
- mp4
- mov
x-apidog-enum:
- value: mp4
name: ''
description: ''
- value: mov
name: ''
description: ''
default: mp4
examples:
- mp4
web_search:
type: boolean
description: Enable online search.
draft:
type: boolean
description: >-
Enable draft mode. When enabled, only 480p resolution is
allowed. Draft task ID is valid for 7 days from draft
creation.
default: false
examples:
- false
nsfw_checker:
type: boolean
description: >-
Defaults to false. When false, no additional content
filtering is applied and results are returned directly
by the model.
x-apidog-orders:
- prompt
- first_frame_url
- last_frame_url
- reference_image_urls
- reference_video_urls
- reference_audio_urls
- return_last_frame
- generate_audio
- resolution
- aspect_ratio
- duration
- output_format
- web_search
- draft
- 01KWKMN7PBRAKVAWC9BZ3PW3YJ
x-apidog-refs:
01KWKMN7PBRAKVAWC9BZ3PW3YJ:
$ref: '#/components/schemas/nsfw_checker'
x-apidog-ignore-properties:
- nsfw_checker
x-apidog-orders:
- model
- callBackUrl
- input
x-apidog-ignore-properties: []
example:
model: bytedance/seedance-2-5
callBackUrl: https://your-domain.com/api/callback
input:
prompt: >-
A tranquil beach at sunset, with gentle waves lapping the
shore, palm trees swaying in the breeze, and seagulls flying
across the orange sky.
reference_image_urls:
- https://example.com/your-image.png
reference_video_urls:
- https://example.com/your-video.mp4
reference_audio_urls:
- https://example.com/your-audio.mp3
return_last_frame: false
generate_audio: false
resolution: 720p
aspect_ratio: '16:9'
duration: 15
responses:
'200':
description: Request successful
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/response%20not%20with%20recordId'
example:
code: 200
msg: success
data:
taskId: task_bytedance_1765186743319
headers: {}
x-apidog-name: ''
security:
- BearerAuth: []
x-apidog:
schemeGroups:
- id: kn8M4YUlc5i0A0179ezwx
schemeIds:
- BearerAuth
required: true
use:
id: kn8M4YUlc5i0A0179ezwx
scopes:
kn8M4YUlc5i0A0179ezwx:
BearerAuth: []
callbacks:
videoTaskCompleted:
'{request.body#/callBackUrl}':
post:
description: >-
The system sends this callback when the `bytedance/seedance-2-5`
task succeeds or fails.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- code
- msg
- data
properties:
code:
type: integer
description: >-
Unified callback code: 200 for success, 501 for
failure.
enum:
- 200
- 501
msg:
type: string
description: Unified callback message.
enum:
- Playground task completed successfully.
- Playground task failed.
data:
type: object
required:
- taskId
- model
- state
- param
properties:
taskId:
type: string
description: The unique task identifier.
model:
type: string
description: The model used for the task.
enum:
- bytedance/seedance-2-5
state:
type: string
description: Terminal task state.
enum:
- success
- fail
param:
type: string
description: >-
JSON string containing the submitted task
parameters.
resultJson:
type: string
nullable: true
description: >-
JSON string. On success it contains resultUrls;
when return_last_frame is true it also contains
lastFrameUrl (JPEG). Present only when state is
success.
failCode:
type: string
nullable: true
description: >-
Failure code, a numeric string such as "400" or
"500". Present only when state is fail.
failMsg:
type: string
nullable: true
description: Failure reason. Present only when state is fail.
costTime:
type: integer
format: int64
description: >-
Processing time in seconds. Present on both
success and failure callbacks.
completeTime:
type: integer
format: int64
description: Task completion timestamp.
createTime:
type: integer
format: int64
description: Task creation timestamp.
updateTime:
type: integer
format: int64
description: >-
Use completeTime as the completion time;
updateTime may equal createTime.
creditsConsumed:
type: number
description: >-
Credits consumed by the task; 0 for failed
tasks.
examples:
success:
summary: Task completed successfully
value:
code: 200
msg: Playground task completed successfully.
data:
taskId: task_example_video_webhook_001
model: bytedance/seedance-2-5
state: success
param: >-
{"input":"{}","callBackUrl":"https://example.com/callback","model":"bytedance/seedance-2-5"}
resultJson: >-
{"resultUrls":["https://example.com/generated-video.mp4"],"lastFrameUrl":["https://example.com/last-frame.jpg"]}
costTime: 12
completeTime: 1234567890
createTime: 1234560000
updateTime: 1234567890
creditsConsumed: 1.23
failure:
summary: Task failed
value:
code: 501
msg: Playground task failed.
data:
taskId: task_example_video_webhook_001
model: bytedance/seedance-2-5
state: fail
param: >-
{"input":"{}","callBackUrl":"https://example.com/callback","model":"bytedance/seedance-2-5"}
failCode: '400'
failMsg:
costTime: 12
creditsConsumed: 0
responses:
'200':
description: Callback received successfully.
content:
application/json:
schema:
type: object
properties:
code:
type: integer
example: 200
msg:
type: string
example: success
example:
code: 200
msg: success
x-apidog-folder: docs/en/Market/Video Models/Bytedance
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/1184766/apis/api-39529049-run
components:
schemas:
nsfw_checker:
type: object
properties:
nsfw_checker:
type: boolean
description: >-
Defaults to false. When false, no additional content filtering is
applied and results are returned directly by the model.
x-apidog-orders:
- nsfw_checker
x-apidog-ignore-properties: []
x-apidog-folder: ''
response not with recordId:
type: object
required:
- data
properties:
code:
type: integer
description: >-
Status code of the request. The HTTP status is 200 even when the
request fails, so always check this field: 200 means success; any
other value means the request failed and msg describes the reason.
Common values: 401 invalid or missing API key; 402 insufficient
credits; 429 rate limit exceeded; 422 or 500 the request could not
be processed (read msg and check your parameters before retrying).
enum:
- 200
- 401
- 402
- 404
- 422
- 429
- 433
- 455
- 500
- 501
- 505
msg:
type: string
description: Response message, error description upon failure
examples:
- success
data:
type: object
required:
- taskId
properties:
taskId:
type: string
description: >-
The task ID can be used with the "Get Task Details" endpoint to
query the task status.
examples:
- dc1928bfcbc77cb6c85f3359a9c718b3
x-apidog-orders:
- taskId
x-apidog-ignore-properties: []
x-apidog-orders:
- code
- msg
- data
x-apidog-ignore-properties: []
x-apidog-folder: ''
securitySchemes:
BearerAuth:
type: bearer
scheme: bearer
bearerFormat: API Key
description: >-
All API requests require a Bearer Token. Add the header `Authorization:
Bearer YOUR_API_KEY` to authenticate requests.
BearerAuth1:
type: bearer
scheme: bearer
bearerFormat: API Key
description: >-
所有 API 请求都需要 Bearer Token。请在请求头中添加 `Authorization: Bearer YOUR_API_KEY`
进行身份验证。
servers:
- url: https://api.kie.ai
description: 正式环境
security:
- BearerAuth: []
x-apidog:
schemeGroups:
- id: kn8M4YUlc5i0A0179ezwx
schemeIds:
- BearerAuth
required: true
use:
id: kn8M4YUlc5i0A0179ezwx
scopes:
kn8M4YUlc5i0A0179ezwx:
BearerAuth: []
```