AI Video Studio / API Ready Text · Reference · Retrieve OpenAI Compatible
Chat Completions Video API

用 OpenAI 调用方式生成 视频

前端、脚本或第三方 SDK 只需要使用本站 Base URL 和客户 API Key,即可创建文生视频、参考图视频和多参考素材视频任务,再通过同一个接口查询结果。

/v1OpenAI 风格路由
Bearer客户 API Key 鉴权
Async创建后轮询查询
Video API preview
Modelsseedance-video / 480p / 720p
Modestext2video / reference2video
Output本地视频访问链接

接口 概览

所有请求都使用当前站点作为 Base URL,鉴权方式与 OpenAI 一致。响应会放在 choices[0].message.content 中,内容是 JSON 字符串。

video 参数

actioncreate 创建任务,retrieve 查询任务。
modetext2videoreference2video,不传时可由图片内容自动推断。
duration支持 581015 秒。
quality支持 480p720p,也可使用对应模型别名。

参考图可直接使用 OpenAI 格式的 image_url。已上传的参考素材可通过 reference_file_idsreference_video_file_idsreference_audio_file_ids 传入;这类 file_id 必须同时传 channel_id,确保素材和生成任务使用同一个上游账号。

调用 示例

$API_KEY 替换为你的客户 Key。创建任务返回 task_id 后,使用查询示例获取进度和最终视频链接。

文生视频

curl ${BASE_URL}/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-video",
    "messages": [
      {"role": "user", "content": "一只小狗在阳光下奔跑,电影感镜头"}
    ],
    "video": {
      "action": "create",
      "mode": "text2video",
      "duration": 5,
      "quality": "720p",
      "aspect_ratio": "16:9"
    }
  }'

参考图片生成视频

curl ${BASE_URL}/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-video",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "@Image1 转身看向镜头,背景轻微推进"},
        {"type": "image_url", "image_url": {"url": "https://example.com/reference.png"}}
      ]
    }],
    "video": {
      "action": "create",
      "mode": "reference2video",
      "duration": 5,
      "quality": "480p",
      "aspect_ratio": "adaptive"
    }
  }'

图片 + 视频 + 音频多参考

curl ${BASE_URL}/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-video",
    "messages": [
      {"role": "user", "content": "@Image1 保持主体,参考 @Video1 的动作,并跟随 @Audio1 的节奏"}
    ],
    "video": {
      "action": "create",
      "mode": "reference2video",
      "reference_file_ids": ["uploaded_image_file_id"],
      "reference_video_file_ids": ["uploaded_video_file_id"],
      "reference_audio_file_ids": ["uploaded_audio_file_id"],
      "channel_id": "channel_xxxxxxxxxxxx",
      "duration": 5,
      "quality": "480p",
      "aspect_ratio": "adaptive"
    }
  }'

查询任务结果

curl ${BASE_URL}/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-video",
    "messages": [{"role": "user", "content": "查询视频任务"}],
    "video": {
      "action": "retrieve",
      "task_id": "video_xxxxxxxxxxxxxxxxxx"
    }
  }'