Appearance
Seedance2.0折扣版(返回官方URL)
baseUrl
baseUrl
BASE_URL = https://apiok.cc支持的模型
doubao-seedance-2.0-discountdoubao-seedance-2.0-discount-1080p
创建视频生成任务接口
| 参数 | 类型 | 说明 |
|---|---|---|
| model | string | 调用模型 |
| prompt | string | 文本提示词输入。 |
| aspect_ratio | string | 输出比例,默认 16:9。可选值:16:9、9:16、1:1、4:3、3:4、21:9、adaptive。 |
| duration | integer | 视频时长,单位秒,默认 5,范围 4-15。 |
| resolution | string | 视频分辨率720p, 1080p (根据所选模型选择适当分辨率) |
| generate_audio | boolean | 是否生成音频,默认 true。 |
| reference_images | string[] | 图片地址。支持公网 URL。如提前上传素材到素材库,也可传素材id,格式: assetId://{assetId} |
| reference_videos | string[] | 视频地址。支持公网 URL。如提前上传素材到素材库,也可传素材id,格式: assetId://{assetId} |
| reference_audios | string[] | 音频地址。支持公网 URL。如提前上传素材到素材库,也可传素材id,格式: assetId://{assetId} |
| first_image | string | 图生视频首帧输入。支持公网 URL。如提前上传素材到素材库,也可传素材id,格式: assetId://{assetId} |
| last_image | string | 视频尾帧约束输入。支持公网 URL。如提前上传素材到素材库,也可传素材id,格式: assetId://{assetId} |
| watermark | boolean | 是否添加上游或平台水印,默认值:false。 |
请求示例
bash
curl --location --request POST ' https://apiok.cc/v1/videos' \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "doubao-seedance-2.0-discount",
"prompt": "A cinematic product shot with natural lighting",
"reference_images": [
"https://example.com/reference.png"
],
"reference_videos": [
"https://example.com/reference.mp4"
],
"reference_audios": [
"https://example.com/reference.mp3"
],
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "480p",
"first_image": "https://example.com/reference.png",
"last_image": "https://example.com/reference.png",
"generate_audio": true,
"watermark": false
}'返回示例
json
{
"id": "task_id",
"task_id": "task_id"
}查询任务状态接口
请求示例
bash
curl -X GET "https://apiok.cc/v1/video/${TASK_ID}" \
-H "Authorization: Bearer ${API_KEY}"返回示例
json
{
"id": "task_xxxxx",
"object": "video",
"model": "doubao-seedance-2.0-discount",
"status": "completed",
"progress": 100,
"created_at": 1788322262,
"completed_at": 1788322611,
"error": {
"message": "",
"code": ""
},
"metadata": {
"url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/xxxx"
},
"result_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/xxxx",
"usage": {
"total_tokens": 173700,
"output_tokens": 173700
}
}status
- queued:排队中。
- in_progress:任务运行中。
- completed: 任务成功。
- failed:任务失败。
⚠️ 注意
如果想要加快视频生成的时间,可以提前调用以下素材创建接口,素材创建成功后(查询素材创建结果的Status为Active),在视频创建的时候url传入"assetId://{assetId}"
创建素材接口
assetType类型:Image(图片)、Video(视频)、Audio(音频)
请求示例
bash
curl --location 'https://apiok.cc/v1/asset/create' \
--header 'Authorization: Bearer api密钥' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-2.0-cf-720p",
"assetType": "Image",
"url": "https://amzn-sub2api.s3.ap-southeast-1.amazonaws.com/newapi/uploads/1785745458553719000.png"
}'- 响应
json
{
"code": "success",
"message": "",
"data": {
"assetId": "asset-20260803172041-kt6gr"
}
}- 成功code: "success"
- 失败code: "failed", message: 失败原因
查询素材创建结果
- 请求示例
bash
curl --location 'https://apiok.cc/v1/asset/result' \
--header 'Authorization: Bearer api密钥' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-2.0-cf-720p",
"assetId": "asset-20260803172041-kt6gr"
}'- 响应示例
json
{
"code": "success",
"message": "",
"data": {
"assetType": "Image",
"assetId": "asset-20260803172041-kt6gr",
"Name": "",
"status": "ACTIVE",
"error": "失败的时候返回失败原因"
}
}请求成功code: "success",失败"failed"
status包含以下状态,仅Active的时候素材才是可用的,其它状态素材均不可用
NONE:素材记录已创建,但尚未开始上传或处理。请稍后再次查询,当前不可提交任务。
UPLOADING:素材正在上传。请等待状态更新,当前不可提交任务。
PROCESSING:素材正在处理中。请稍后再次查询,当前不可提交任务。
ACTIVE:素材已处理完成且可用。只有此状态可以提交视频生成任务。
FAILED:素材处理失败。请查看 errorMessage,处理问题后重新提交素材。
EXPIRED:素材已过期,当前不可用。请继续查询并等待重新处理为 ACTIVE,必要时重新提交素材。
DELETED:素材已被删除或已失效,当前不可用。请重新提交素材并等待状态变为 ACTIVE。