APIOK 文档

Appearance

Seedance-2.0特价版（431残血版）文档 ​

支持的模型 ​

  • seedance-2.0

调用流程 ​

    1. POST /v1/videos 提交任务
    1. GET /v1/videos/{task_id} 轮询（建议间隔 5–10 秒）
    1. status=completed 后从 video_url 下载成片

输出规格 ​

  • 标准 480p / HD 720p，H.264，时长 4–15 秒
  • 16:9 像素：标准 864×496，HD 1280×720；不支持 1080p / 4K
  • 画幅支持 16:9、9:16、1:1、21:9、3:4、4:3

限制 ​

  • 多模态：参考图≤4、参考视频≤3（单条 4–15 秒，总时长 ≤15 秒）、参考音频≤1（≤15 秒）。
  • 参考素材
  • 参考图须传 HTTPS 公网直链字段 image、 reference_image_urls。
  • 参考视频/音频仍须传 HTTPS 公网直链（reference_videos、reference_audios）。
  • 参考视频分辨率：每边 720–2160 px。
  • 多模态与首尾帧互斥。

常见错误码 ​

bash
GENERATION_FAILED · 生成失败或内容策略拦截
TIMEOUT · 生成超时
NO_ACCOUNT · 服务繁忙，请稍后重试

四种生成模式 ​

  • 服务端按素材字段自动判定，无需传 mode 参数。

  • 模式 最少必传 触发字段 prompt 引用

  • 多模态 reference_image_urls / reference_videos / reference_audios

  • 参考图≤4、视频≤3（总时长≤15s）、音频≤1（≤15s）；与首尾帧互斥

  • @image1 … @image4、@video1 … @video3、@audio1

  • 首尾帧 prompt + 首帧 + 尾帧 first_image_url + last_image_url（成对）

  • 与多模态互斥

创建视频任务（application/json）。 ​

http
POST
https://apiok.cc/v1/videos
  • 请求字段
  • model：必填，传 public 名 seedance-2.0 / seedance-2.0-fast（与模型广场一致）。
  • prompt：必填。视频描述，≤5000 字符。多模态可用 @image1 … @video1 … @audio1 占位。
  • aspect_ratio：画幅，默认 16:9。支持 16:9、9:16、1:1、21:9、3:4、4:3。
  • duration：时长秒数，4–15 任意整数。
  • resolution：清晰度：480p（标准，16:9=864×496）或 720p（HD，16:9=1280×720）。不支持 1080p/4K。
  • audio：是否生成原生音频，默认 true。
  • image_url：主参考图：公网 HTTPS 直链或 data:image/...;base64,...。单图生视频或多模态第 1 张。
  • reference_image_urls：多模态额外参考图（HTTPS 直链或 data URI，与 image_url 合计最多 4 张）。
  • reference_videos：参考视频 HTTPS 直链数组（≤3，单条 4–15 秒，总时长 ≤15 秒，每边 720–2160 px）。
  • reference_audios：参考音频 HTTPS 直链数组（≤1，≤15 秒）。
  • first_image_url：首尾帧：首帧（HTTPS 直链或 data URI；须与 last_image_url 成对，与多模态互斥）。
  • last_image_url：首尾帧：尾帧（HTTPS 直链或 data URI；须与 first_image_url 成对）。
  • image：multipart 单图上传（-F image=@photo.jpg）；多图请用 JSON 数组。

文生视频 ​

json
{
  "aspect_ratio": "16:9",
  "duration": 8,
  "model": "seedance-2.0",
  "prompt": "雨夜霓虹街道，镜头缓慢推进，电影感光影",
  "resolution": "720p"
}

单图生视频（公网 URL） ​

json
{
  "aspect_ratio": "16:9",
  "duration": 5,
  "image_url": "https://cdn.example.com/photo.jpg",
  "model": "seedance-2.0",
  "prompt": "保持人物一致，缓慢走动"
}

图生视频多模态 ​

json
{
  "aspect_ratio": "1:1",
  "audio": true,
  "duration": 4,
  "image_url": "https://cdn.example.com/img1.jpg",
  "model": "seedance-2.0",
  "prompt": "参考@image1与@image2，动作@video1，配乐@audio1",
  "reference_audios": [
    "https://cdn.example.com/ref.mp3"
  ],
  "reference_image_urls": [
    "https://cdn.example.com/img2.jpg"
  ],
  "reference_videos": [
    "https://cdn.example.com/ref.mp4"
  ],
  "resolution": "480p"
}

图生视频首尾帧过渡 ​

json
{
  "duration": 5,
  "first_image_url": "https://cdn.example.com/start.jpg",
  "last_image_url": "https://cdn.example.com/end.jpg",
  "model": "seedance-2.0",
  "prompt": "平滑电影感过渡"
}

查询任务状态与结果。 ​

http
GET
https://apiok.cc/v1/videos/{task_id}

下载成片（亦可直接使用响应中的 video_url）。 ​

http
GET
https://apiok.cc/v1/videos/{task_id}/content

鉴权：Authorization: Bearer sk-你的令牌。失败任务通常不计费，具体以模型广场计费说明为准。