APIOK 文档

Appearance

seedance-2.0优惠版接口文档 ​

1.支持的模型 ​

  • seedance 2.0-fast-720p-dj

2. 流程 ​

  1. 请求生成视频任务
  2. 查询视频生成进度
  3. 获取生成的视频

3. 请求生成视频任务 ​

  • model: 必填 seedance 2.0-fast-720p-dj
  • prompt: 画面描述，最长 4000 字符。prompt 和 images 至少要给一个
  • duration: 时长秒数，支持 5 ~ 15 秒的整数，默认 5
  • aspect_ratio: 画面比例，只支持 16:9 / 9:16 / 1:1 / 4:3 / 3:4，默认 16:9
  • resolution: 清晰度。不用传，服务端固定按 720p 下发
  • generate_audio: 当前模型不支持生成声音
  • size: 像素尺寸，如 1280x720。留空更稳（画幅已由 aspect_ratio 表达），只在明确要求某个分辨率时传
  • images: string[] 全能参考的参考图，最多 9 张

示例 ​

  • 请求
bash
curl --location --request POST 'https://apiok.cc/v1/videos' \
--header 'Authorization: $APIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "seedance 2.0-fast-720p-dj",
    "prompt": "生成一只可爱的小狗跳舞的视频",
    "duration": 5,
    "aspect_ratio": "16:9",
    "images": [
        "https://pic.nximg.cn/file/20230517/11949215_143004845103_2.jpg"
    ]
}'
  • 返回
json
{
    "id": "task_Viz2kwzAKz1CSlcegNcLyttS4YKBLZdF",
    "task_id": "task_Viz2kwzAKz1CSlcegNcLyttS4YKBLZdF",
    "object": "",
    "model": "seedance 2.0-fast-720p-dj",
    "status": "排队中",
    "progress": 0,
    "created_at": 0,
    "error": {
        "message": "",
        "code": ""
    },
    "usage": {
        "completion_tokens": 0,
        "total_tokens": 0
    }
}

4. 查询视频生成进度 ​

  • status: completed-完成 queued-排队 in_progress/pennding-进行中 failed-失败 unknown 还未同步
  • progress: 进度百分比
  • URI中taskId 来自生成视频返回的taskId

示例 ​

  • 请求
bash
curl --location --request GET 'https://apiok.cc/v1/videos/task_Xo9GVEE6qfzRaLsd69mEjelKMydlg7QS' \
--header 'Authorization: $APIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{}'
  • 返回
json
{
    "id": "task_Xo9GVEE6qfzRaLsd69mEjelKMydlg7QS",
    "object": "video",
    "model": "seedance 2.0-fast-720p-dj",
    "status": "completed",
    "progress": 100,
    "created_at": 1784875061,
    "completed_at": 1784875095,
    "seconds": "5",
    "metadata": {
        "url": "https://apiok.cc/v1/videos/task_Xo9GVEE6qfzRaLsd69mEjelKMydlg7QS/content"
    }
}

5. 获取生成的视频 ​

  • url: 来自查询进度时候，返回的metadata.url

示例 ​

  • 请求
bash
curl --location --request GET 'https://apiok.cc/v1/videos/task_Xo9GVEE6qfzRaLsd69mEjelKMydlg7QS/content' \
--header 'Authorization: $APIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{}