Skip to content

Seedance2.0折扣版(返回官方URL) ​

baseUrl ​

baseUrl
BASE_URL = https://apiok.cc

支持的模型 ​

  • doubao-seedance-2.0-discount
  • doubao-seedance-2.0-discount-1080p

创建视频生成任务接口 ​

参数类型说明
modelstring调用模型
promptstring文本提示词输入。
aspect_ratiostring输出比例,默认 16:9。可选值:16:9、9:16、1:1、4:3、3:4、21:9、adaptive。
durationinteger视频时长,单位秒,默认 5,范围 4-15。
resolutionstring视频分辨率720p, 1080p (根据所选模型选择适当分辨率)
generate_audioboolean是否生成音频,默认 true。
reference_imagesstring[]图片地址。支持公网 URL。如提前上传素材到素材库,也可传素材id,格式: assetId://{assetId}
reference_videosstring[]视频地址。支持公网 URL。如提前上传素材到素材库,也可传素材id,格式: assetId://{assetId}
reference_audiosstring[]音频地址。支持公网 URL。如提前上传素材到素材库,也可传素材id,格式: assetId://{assetId}
first_imagestring图生视频首帧输入。支持公网 URL。如提前上传素材到素材库,也可传素材id,格式: assetId://{assetId}
last_imagestring视频尾帧约束输入。支持公网 URL。如提前上传素材到素材库,也可传素材id,格式: assetId://{assetId}
watermarkboolean是否添加上游或平台水印,默认值: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。