申请流程
要使用 API，需要先到 SeeDance Videos Generation API 对应页面申请对应的服务，进入页面之后，点击「Acquire」按钮，如图所示：
如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。
在首次申请时会有免费额度赠送，可以免费使用该 API。
基本使用
首先先了解下基本的使用方式，就是输入提示词content.text、类型content.type=text 以及模型 model，便可获得处理后的结果，具体的内容如下：
accept：想要接收怎样格式的响应结果，这里填写为application/json，即 JSON 格式。authorization：调用 API 的密钥，申请之后可以直接下拉选择。
model：生成视频的模型，可选值：doubao-seedance-1-0-pro-250528、doubao-seedance-1-0-pro-fast-251015、doubao-seedance-1-5-pro-251215、doubao-seedance-1-0-lite-t2v-250428、doubao-seedance-1-0-lite-i2v-250428。content：输入内容数组，type可以是text或image_url。resolution：输出分辨率，可选480p/720p/1080p。ratio：宽高比，可选16:9/4:3/1:1/3:4/9:16/21:9/adaptive。duration：视频时长（秒），范围 2–12。seed：随机种子，整数，-1 到 4294967295。camerafixed：是否固定摄像头，true/false。watermark：是否添加水印，true/false。generate_audio：是否生成有声视频，true/false，仅doubao-seedance-1-5-pro-251215支持。service_tier：推理模式，default（在线）或flex（离线，价格为在线的 50%）。return_last_frame：是否在结果中返回视频最后一帧图片 URL。execution_expires_after：任务超时时间（秒），范围 3600–259200。callback_url：异步回调地址，设置后 API 立即返回task_id，任务完成时将结果 POST 到该地址。
success，此时视频生成任务的状态情况。task_id，此时视频生成任务ID。trace_id，此时视频生成跟踪ID。data，此时视频生成任务的结果列表。task_id，此时视频生成任务的服务器端ID。video_url，此时视频生成任务的视频链接。status，此时视频生成任务的状态。model，生成视频使用的模型。
data 的视频链接地址获取生成的SeeDance视频即可。
另外如果想生成对应的对接代码，可以直接复制生成，例如 CURL 的代码如下：
内联参数说明
在content[].text 提示词末尾，可以通过追加 --parameter value 的形式传入生成参数（旧方式，弱校验，填写有误时自动使用默认值）。完整参数列表如下：
| 内联参数 | 对应字段 | 说明 | 取值范围 |
|---|---|---|---|
--rs | resolution | 输出分辨率 | 480p / 720p / 1080p |
--rt | ratio | 宽高比 | 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive |
--dur | duration | 视频时长（秒） | 2–12 |
--frames | frames | 视频帧数 | [29, 289] 中满足 25+4n 的整数 |
--fps | framespersecond | 帧率 | 仅支持 24 |
--seed | seed | 随机种子 | -1 到 4294967295 |
--cf | camerafixed | 是否固定摄像头 | true / false |
--wm | watermark | 是否添加水印 | true / false |
推荐做法：直接在 Request Body 中使用对应的顶层字段（如resolution、ratio等），为强校验模式，参数填写有误时会返回明确错误提示，更易于排查问题。
生成有声视频
doubao-seedance-1-5-pro-251215 支持通过 generate_audio 参数生成带音频的视频：
图生视频首帧
如果想图生视频任务，首先content 参数需要包含 type 为 image_url 的项，image_url 字段必须为对象格式：{"url": "https://..."} 或 Base64 格式 {"url": "data:image/png;base64,..."}。
注意：对应的代码：image_url不支持直接传入字符串格式（如"image_url": "https://..."），必须使用对象格式"image_url": {"url": "https://..."}，否则会返回 400 错误。
图生视频首尾帧
如果想图生视频首尾帧， 首先参数content必须传入类型image_url,并且分别设置role为first_frame和last_frame，就可以指定如下内容：
- role：指定首帧或者尾帧。
- image_url
- url 图片链接
同时
content还需要输入类型text作为prompt提示词
- url 图片链接
同时
异步回调
由于 SeeDance Videos Generation API 生成时间较长（约 1-2 分钟），可通过callback_url 字段使用异步模式，避免 HTTP 连接长时间占用。
整体流程：客户端发起请求时指定 callback_url，API 立即返回包含 task_id 的响应；任务完成后，平台将生成结果以 POST JSON 的形式发送到 callback_url，结果中同样包含 task_id 以便关联。
callback_url 的内容如下：
task_id 字段与请求时返回的一致，通过该字段即可实现任务的关联。
错误处理
在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：400 token_mismatched：Bad request, possibly due to missing or invalid parameters.400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.401 invalid_token：Unauthorized, invalid or missing authorization token.429 too_many_requests：Too many requests, you have exceeded the rate limit.500 api_error：Internal server error, something went wrong on the server.