APIOK 文档

Appearance

seedance-2.0-eo 接口文档 ​

支持的模型 ​

  • seedance-2.0-eo

1. 流程 ​

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

2. 请求生成视频任务 ​

  • model: 必填 $model
  • prompt: 画面描述，最长 4000 字符。prompt 和 images 至少要给一个
  • duration: 时长秒数，支持 4 ~ 30 秒的整数，默认 4
  • width: 宽度
  • height: 高度

宽高只能取对应宽高比中的对应值

  • 宽高16:9 standard: 864 * 496 HD: 1280 * 720 Full-HD: 1920 * 1080 4K: 3840 * 2160
  • 宽高1:1 standard: 640 * 640 HD: 960 * 960 Full-HD: 1440 * 1440 4k: 2880 * 2880
  • 宽高9:19 stardard: 496 * 864 HD: 720 * 1280 Full-HD: 1080 * 1920 4k: 2160 * 3840
  • startFrameUrl: 首帧
  • endFrameUrl: 尾帧
  • image_reference: string[] 参考图片数组，最多支持4张
  • video_reference: string[] 参考视频数组，对多支持3个
  • audio_reference: string[] 参考音频数组，目前只支持一个

示例 ​

请求 ​

bash
curl --location --request POST 'https://apiok.cc/v1/videos' \
--header 'Authorization: $APIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "$model",
    "width": 720,
    "height": 1280,
    "duration": 4,
    "prompt": "generate a cry video",
    "image_reference":[
        "https://gd-hbimg.huaban.com/b7326d24b657d41e12dac49ba56e791a77006fd1246dd4-41T64g_fw658"
    ],
    "video_reference":[],
    "audio_reference":[]
}'

返回 ​

json
{
    "id": "task_Viz2kwzAKz1CSlcegNcLyttS4YKBLZdF",
    "task_id": "task_Viz2kwzAKz1CSlcegNcLyttS4YKBLZdF",
    "object": "",
    "model": "",
    "status": "queued",
    "progress": 0,
    "created_at": 0,
    "error": {
        "message": "",
        "code": ""
    },
    "usage": {
        "completion_tokens": 0,
        "total_tokens": 0
    }
}

2. 查询视频生成进度 ​

  • 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": "$model",
    "status": "completed",
    "progress": 100,
    "created_at": 1784875061,
    "completed_at": 1784875095,
    "seconds": "5",
    "metadata": {
        "url": "https://apiok.cc/v1/videos/task_Xo9GVEE6qfzRaLsd69mEjelKMydlg7QS/content"
    }
}

3. 获取生成的视频 ​

  • 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 '{}