跳转到主要内容
POST
/
v1
/
video
/
generations
curl --request POST \
  --url 'https://api.elkapi.com/v1/video/generations' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "第一人称视角果茶宣传广告，手摘苹果、鲜切现摇、成品特写，电影感，高细节",
    "metadata": {
      "duration": 8,
      "ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false
    }
  }'

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

Documentation Index

Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url 'https://api.elkapi.com/v1/video/generations' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "第一人称视角果茶宣传广告，手摘苹果、鲜切现摇、成品特写，电影感，高细节",
    "metadata": {
      "duration": 8,
      "ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false
    }
  }'

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

​
Authorizations

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证。
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
默认值:"doubao-seedance-2-0-260128"
必填
Seedance 模型 ID。可用值：doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128
​
prompt
string
必填
文本提示词。当前适配器会把该字段作为最终的 content 文本条目发送给上游。
​
images
array<string>
图片 URL 或 Base64 数组。需要指定 role 时，建议改用 metadata.content。
​
seconds
string
视频时长秒数。填写后会覆盖 metadata.duration。
​
metadata
object
透传给 Seedance 上游的参数对象。Seedance 官方字段请放在这里。
​
metadata.duration
integer
视频时长，Seedance 2.0 通常为 4 到 15 秒，也可按上游支持传 -1。
​
metadata.ratio
string
视频比例。示例：16:9、4:3、1:1、3:4、9:16、21:9、adaptive
​
metadata.resolution
string
分辨率。示例：480p、720p、1080p
​
metadata.generate_audio
boolean
是否生成音频。
​
metadata.watermark
boolean
是否添加水印。
​
metadata.seed
integer
随机种子。
​
metadata.content
array<object>
多模态参考内容。支持 image_url、video_url、audio_url；文本内容请使用顶层 prompt。
[
  {
    "type": "image_url",
    "image_url": {
      "url": "https://example.com/reference.png"
    },
    "role": "reference_image"
  },
  {
    "type": "video_url",
    "video_url": {
      "url": "https://example.com/reference.mp4"
    },
    "role": "reference_video"
  },
  {
    "type": "audio_url",
    "audio_url": {
      "url": "https://example.com/reference.mp3"
    },
    "role": "reference_audio"
  }
]

​
多模态示例

curl --request POST \
  --url 'https://api.elkapi.com/v1/video/generations' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "全程使用参考视频的第一视角构图，使用参考音频作为背景音乐，生成果茶宣传广告",
    "metadata": {
      "duration": 11,
      "ratio": "16:9",
      "generate_audio": true,
      "watermark": false,
      "content": [
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/first-frame.jpg"
          },
          "role": "reference_image"
        },
        {
          "type": "video_url",
          "video_url": {
            "url": "https://example.com/reference.mp4"
          },
          "role": "reference_video"
        },
        {
          "type": "audio_url",
          "audio_url": {
            "url": "https://example.com/music.mp3"
          },
          "role": "reference_audio"
        }
      ]
    }
  }'

​
Response

​
id
string
ElkAPI 返回的公开任务 ID。
​
task_id
string
兼容字段，值与 id 一致。
​
object
string
对象类型，固定为 video。
​
model
string
请求使用的模型。
​
status
string
任务状态。提交成功后通常为 queued。
​
created_at
integer
任务创建时间戳。