哈基米API站

Appearance

提交视频生成任务（OpenAI 兼容格式） ​

使用 OpenAI 兼容格式提交 Seedance 2.0 视频生成任务。该接口适合已经按 OpenAI 风格封装请求的程序，扩展参数统一放在 metadata 中。

完美兼容 New API / One API

本接口完美支持 New API、One API 等各类中转分发平台。 如果你正在使用中转平台，请直接调用本接口，而不要使用 豆包原生格式提交接口（中转系统不兼容自定义的非 /v1 路径）。

接口信息 ​

项目值
方法POST
路径/v1/video/generations
完整地址https://api.gemai.cc/v1/video/generations
鉴权Authorization: Bearer sk-你的令牌

和豆包原生格式的区别 ​

对比项OpenAI 兼容格式
提示词顶层 prompt
图片输入顶层 image
扩展参数metadata 对象
时长字段seconds，字符串类型，例如 "5"、"-1"

如需完全按豆包官方结构传入 content 数组，请使用 豆包原生提交接口。

文生视频 ​

json
{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "宇航员在月球表面慢慢行走，地球悬挂在黑色天空中，画面宏大震撼",
  "seconds": "-1",
  "metadata": {
    "ratio": "16:9",
    "resolution": "720p"
  }
}

图生视频 ​

json
{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "让图片中的人物微笑并缓缓转身，眼神温柔",
  "image": "https://example.com/portrait.jpg",
  "seconds": "5",
  "metadata": {
    "ratio": "16:9"
  }
}

视频续拍 ​

视频续拍需要把视频引用放到 metadata.content 中。

json
{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "继续往前走，走向远处连绵起伏的山丘，镜头缓缓推进",
  "seconds": "5",
  "metadata": {
    "content": [
      {
        "type": "video_url",
        "video_url": {
          "url": "https://example.com/input-clip.mp4"
        }
      }
    ]
  }
}

代码示例 ​

bash
curl --location 'https://api.gemai.cc/v1/video/generations' \
  --header "Authorization: Bearer $GEMAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "海边日落，镜头缓慢推进，真实摄影风格",
    "seconds": "5",
    "metadata": {
      "ratio": "16:9",
      "resolution": "720p"
    }
  }'
javascript
const response = await fetch('https://api.gemai.cc/v1/video/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.GEMAI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'doubao-seedance-2-0-260128',
    prompt: '海边日落，镜头缓慢推进，真实摄影风格',
    seconds: '5',
    metadata: {
      ratio: '16:9',
      resolution: '720p',
    },
  }),
})

console.log(await response.json())
python
import os
import requests

response = requests.post(
    'https://api.gemai.cc/v1/video/generations',
    headers={
        'Authorization': f"Bearer {os.environ['GEMAI_API_KEY']}",
        'Content-Type': 'application/json',
    },
    json={
        'model': 'doubao-seedance-2-0-260128',
        'prompt': '海边日落，镜头缓慢推进，真实摄影风格',
        'seconds': '5',
        'metadata': {
            'ratio': '16:9',
            'resolution': '720p',
        },
    },
    timeout=120,
)

response.raise_for_status()
print(response.json())

返回示例 ​

json
{
  "id": "task_abc123def456",
  "task_id": "task_abc123def456",
  "object": "video",
  "model": "doubao-seedance-2-0-260128",
  "status": "queued",
  "progress": 0,
  "created_at": 1712345678
}

注意事项 ​

  • 该接口只提交任务，结果需要继续查询 OpenAI 兼容任务状态。
  • seconds 是字符串类型，"-1" 表示由模型自动选择时长。
  • ratio、resolution、watermark、seed 等扩展参数请放在 metadata 中。