视频生成接口

Seedance、Doubao 等渠道使用通用任务协议。接入 OpenAI 视频协议的模型使用 /v1/videos 端点。模型与渠道支持的参考资源类型可能不同。

Base URL

Base URL

复制

https://api.qiuqiutoken.net/v1

Seedance / Doubao 通用任务协议

创建任务

POST/v1/video/generations

创建视频任务

复制

https://api.qiuqiutoken.net/v1/video/generations

字段	是否必填	说明
model	必填	视频模型名称，例如 doubao-seedance-2-0-260128。
prompt	必填	视频内容、镜头和声音要求。
seconds	可选	用于指定视频时长的字符串，例如 "5"。
metadata.content	可选	参考图片、视频或音频。仅适用于支持对应参考资源的模型和渠道。
metadata.resolution	可选	输出分辨率，例如 720p。
metadata.ratio	可选	画面比例，例如 16:9。
metadata.generate_audio	可选	是否生成音频。
metadata.watermark	可选	是否添加水印。

文本生成视频

bash

复制

curl -X POST "https://api.qiuqiutoken.net/v1/video/generations" -H "Authorization: Bearer sk-XXXX" -H "Content-Type: application/json" -d '{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "一位女性漫步东京街头，电影感镜头",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
  }
}'

使用参考资源

参考资源放在 metadata.content 中，文本提示词仍使用顶层 prompt。

bash

复制

curl -X POST "https://api.qiuqiutoken.net/v1/video/generations" -H "Authorization: Bearer sk-XXXX" -H "Content-Type: application/json" -d '{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "使用参考素材的构图、产品外观和背景音乐，制作第一人称果茶广告",
  "seconds": "11",
  "metadata": {
    "content": [
      {
        "type": "image_url",
        "image_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
        },
        "role": "reference_image"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
        },
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
        },
        "role": "reference_video"
      },
      {
        "type": "audio_url",
        "audio_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
        },
        "role": "reference_audio"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
  }
}'

查询任务

GET/v1/video/generations/{task_id}

查询视频任务

复制

https://api.qiuqiutoken.net/v1/video/generations/{task_id}

bash

复制

curl -X GET "https://api.qiuqiutoken.net/v1/video/generations/{task_id}" -H "Authorization: Bearer sk-XXXX"

字段	说明
code	请求结果代码。
message	请求结果说明。
data	任务数据；任务完成后，视频地址位于 data.result_url。

OpenAI / Sora 协议

适用于支持 OpenAI 视频协议的模型和渠道。

创建任务

POST/v1/videos

创建 OpenAI 视频任务

复制

https://api.qiuqiutoken.net/v1/videos

bash

复制

curl -X POST "https://api.qiuqiutoken.net/v1/videos" -H "Authorization: Bearer sk-XXXX" -F "model=sora-2" -F "prompt=一只三花猫在舞台上弹钢琴"

查询任务

GET/v1/videos/{task_id}

查询 OpenAI 视频任务

复制

https://api.qiuqiutoken.net/v1/videos/{task_id}

下载视频

GET/v1/videos/{task_id}/content

下载 OpenAI 视频

复制

https://api.qiuqiutoken.net/v1/videos/{task_id}/content

OpenAI 协议的完整字段和响应定义见 OpenAI 视频 API Reference。