Seedance 2.5 API 接入文档

使用 VezAPI 密钥接入 Seedance 2.5。下列操作共用同一个账号余额和鉴权方式。

服务地址： https://api.vezapi.com
请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。

Bytedance Seedance 2.5 Draft

POST/api/v1/jobs/createTask

模型标识： bytedance/seedance-2-5-draft

参数	类型	说明与限制
`model` 必填	`string`	用于生成的模型名称。必填字段。 - 此端点必须为 `bytedance/seedance-2-5-draft` 可选值：`"bytedance/seedance-2-5-draft"` 默认：`"bytedance/seedance-2-5-draft"`
`callBackUrl` 可选	`string`	用于接收生成任务完成更新的 URL。可选，但建议在生产环境中使用。 - 系统将在生成完成时通过 POST 请求将任务状态和结果发送到此 URL - 回调包含生成的内链 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 有效负载的 POST 请求 - 或者，使用“获取任务详情”端点轮询任务状态 - 为确保回调安全，请参阅[Webhook 验证指南](/common-api/webhook-verification)了解签名验证实现
`input` 必填	`object`	生成任务的输入参数
`input.draft_task_id` 必填	`string`	来自seedance 2.5 生成任务的任务 ID。自样片创建起 7 天内有效。
`input.resolution` 必填	`string`	输出视频分辨率。可选值：`"1080p"`
`input.output_format` 可选	`string`	输出视频格式。可选值：`"mp4", "mov"`
`input.return_last_frame` 可选	`boolean`	是否返回视频最后一帧图片。默认：`false`
`input.nsfw_checker` 可选	`boolean`	默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例

curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "bytedance/seedance-2-5-draft",
  "input": {
    "draft_task_id": "Your prompt",
    "resolution": "1080p"
  }
}'

返回值与错误

HTTP 200

Request successful

参数	类型	说明与限制
`code` 可选	`integer`	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). 可选值：`200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505`
`msg` 可选	`string`	Response message, error description upon failure
`data` 必填	`object`
`data.taskId` 必填	`string`	The task ID can be used with the "Get Task Details" endpoint to query the task status.

Bytedance Seedance 2.5

POST/api/v1/jobs/createTask

模型标识： bytedance/seedance-2-5

参数	类型	说明与限制
`model` 必填	`string`	用于生成任务的模型名称。必填字段。 - 该接口必须使用 `bytedance/seedance-2-5` 模型可选值：`"bytedance/seedance-2-5"` 默认：`"bytedance/seedance-2-5"`
`callBackUrl` 可选	`string`	接收生成任务完成通知的回调 URL。可选配置，生产环境建议使用。 - 任务生成完成后，系统会向该 URL 以 POST 方式推送任务状态和结果 - 回调内容包含生成内容的 URL 及任务相关信息 - 你的回调接口需支持接收 POST 请求及 JSON 格式的请求体 - 也可选择调用任务详情接口，主动轮询任务状态
`input` 必填	`object`	生成任务的输入参数
`input.prompt` 可选	`string`	用于视频生成的文本提示词。（最大长度：20480 字符） `maxLength: 20480`
`input.first_frame_url` 可选	`string`	首帧图片地址或者asset://{assetId} (例如: asset://asset-20260404242101-76djj) 不能与 reference_image_urls、reference_video_urls、reference_audio_urls 同时使用。
`input.last_frame_url` 可选	`string`	尾帧图片地址或者asset://{assetId} (例如: asset://asset-20260404242101-76djj) 不可单独只传 last_frame_url，必须同时传入 first_frame_url。
`input.reference_image_urls` 可选	`array`	输入图像 URL 或者asset://{assetId} (例如: asset://asset-20260404242101-76djj)列表。传入单张图片要求: 格式：jpeg、png、webp。宽高比（宽/高）： (0.4, 2.5) 宽高长度（px）：(300, 6000) 大小：单张图片小于 30 MB。最多 30 张。与首尾帧场景互斥； `maxItems: 30`
`input.reference_video_urls` 可选	`array`	输入视频网址或者asset://{assetId} (例如: asset://asset-20260404242101-76djj)列表。单个视频要求: 视频格式：mp4、mov、mkv。分辨率：480p、720p 尺寸：宽高比（宽/高）：[0.4, 2.5] 宽高长度（px）：[300, 6000] 总像素数：[640×640=409600, 834×1112=927408]，即宽和高的乘积符合 [409600, 927408] 的区间要求。大小：单个视频不超过 200 MB。帧率 (FPS)：[24, 60] 单个视频时长 [2, 30] s；与首尾帧场景互斥；参考视频总时长不超过 30 秒。 `maxItems: 10`
`input.reference_audio_urls` 可选	`array`	输入音频 URL或者asset://{assetId} (例如: asset://asset-20260404242101-76djj)列表。单个音频要求: 格式：wav、mp3、aac、ogg 大小：单个音频不超过 15 MB。单个音频时长 [2, 30] 秒；与首尾帧互斥；参考音频总时长不超过 30 秒。 `maxItems: 10`
`input.return_last_frame` 可选	`boolean`	是否额外返回生成视频的最后一帧（JPEG，位于 resultJson.lastFrameUrl），默认 false。默认：`false`
`input.generate_audio` 可选	`boolean`	是否生成与画面同步的音频，默认 true。默认：`true`
`input.resolution` 可选	`string`	视频分辨率 - 480p 生成速度更快，720p 兼顾速度与画质可选值：`"480p", "720p", "1080p"` 默认：`"720p"`
`input.aspect_ratio` 可选	`string`	视频画面比例配置。可选值：`"1:1", "4:3", "3:4", "16:9", "9:16", "21:9", "adaptive"` 默认：`"adaptive"`
`input.duration` 可选	`integer`	视频时长4-30（秒）。特殊值 -1: 传 -1 表示自动选择时长——由模型自己决定合适的视频时长（视频编辑任务下会匹配输入视频的时长；其他任务类型则在有效取值范围内自主选择），不需要你指定具体数值。默认：`5`
`input.output_format` 可选	`string`	视频输出格式。可选值：`"mp4", "mov"` 默认：`"mp4"`
`input.web_search` 可选	`boolean`	是否开启联网搜索
`input.draft` 可选	`boolean`	默认false (开关) 开启只能传480p；样片任务 ID 自创建起 7 天内有效。默认：`false`
`input.nsfw_checker` 可选	`boolean`	默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例

curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "bytedance/seedance-2-5",
  "input": {
    "prompt": "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",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5
  }
}'

返回值与错误

HTTP 200

请求成功

参数	类型	说明与限制
`code` 可选	`integer`	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). 可选值：`200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505`
`msg` 可选	`string`	Response message, error description upon failure
`data` 必填	`object`
`data.taskId` 必填	`string`	The task ID can be used with the "Get Task Details" endpoint to query the task status.

任务状态与回调

异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询，或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。

超时可能表示请求已经受理。请在控制台查看原请求，不要自动新建任务。回调可能重试并重复到达，请使用 X-VezAPI-Event-Id 去重。

文件、日志与计费

生成媒体通常随上游保留 14 天，上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源，不提供永久作品库。请求日志保留两个自然月。

调用前预留积分，最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。