EZLINK AI API
  1. Video
EZLINK AI API
  • Video
    • Veo3视频生成
      POST
    • 即梦视频生成
      POST
    • 可灵视频生成
      POST
    • 视频生成结果查询
      GET
  • Image
    • openai兼容格式(同步)
    • 异步兼容格式
      • Flux异步图像生成
      • 可灵绘图
      • 异步图像结果查询
  • LLMs
    • openai兼容
  1. Video

即梦视频生成

POST
/v1/video/generations
使用火山引擎即梦(豆包)模型进行视频生成。支持文生视频和图生视频,遵循火山引擎官方API规范。

支持的即梦模型:#

版本模型系列:#

doubao-seedance-1-0-lite-i2v-250428:图生视频增强版,支持首帧图片+尾帧图片(可选)+文本提示词(可选)+参数(可选)生成目标视频。注意:使用首尾帧功能时,仅支持480p和720p分辨率
doubao-seedance-1-0-lite-t2v-250428:文生视频增强版,根据文本提示词+参数(可选)生成目标视频
doubao-seedance-1-0-pro-250528:专业版模型,支持文生视频和图生视频,提供更高质量的视频生成

请求体格式:#

即梦模型使用content数组格式,遵循火山引擎官方API规范:
model:模型ID
content:内容数组,支持文本和图片类型
callback_url:可选的回调URL

即梦模型图片使用说明:#

图片类型支持:#

首帧图生视频:传入1个image_url对象,role为first_frame或不填
首尾帧图生视频:传入2个image_url对象,一个role为first_frame,另一个role为last_frame

首尾帧功能详细说明:#

使用首尾帧图生视频功能时:需传入2个image_url对象,1个role为first_frame,另一个role为last_frame
图片要求:传入的首尾帧图片可相同
宽高比处理:首尾帧图片的宽高比不一致时,以首帧图片为主,尾帧图片会自动裁剪适配
分辨率限制:使用首尾帧功能时,仅支持480p和720p分辨率
首帧图生视频功能时:role填写first_frame或不填

图片格式支持:#

URL方式:image_url.url字段,支持HTTP/HTTPS协议的图片链接
Base64方式:image_url.image_url字段,格式为data:image/[格式];base64,[数据]

即梦模型文本命令:#

即梦模型支持在文本提示词后追加参数命令,格式为 --[参数名] [值],控制视频输出的规格:

常用参数:#

--ratio [宽高比]:如 16:9、9:16、1:1、adaptive、keep_ratio等
--duration [时长]:视频时长(秒),如 5、10
--rs [分辨率]:分辨率,如 480p、720p、1080p
--fps [帧率]:帧率,如 16、24
--wm [true/false]:是否包含水印
--seed [数字]:随机种子,-1为随机
--cf [true/false]:是否固定摄像头

示例:#

多个镜头。一名侦探进入一间光线昏暗的房间 --ratio 16:9 --duration 5 --fps 24
**注意:**使用不同的模型,可能对应支持不同的参数与取值。当输入的参数或取值不符合所选的模型时,内容会被忽略或报错。
参考文档:火山引擎官方文档

Request

Header Params
Content-Type
string 
optional
请求体类型,固定为 application/json
Example:
application/json
Authorization
string 
optional
API 鉴权 Token,格式为 Bearer {API_KEY}
Example:
Bearer sk-soMNI5jlatIxMzwDA8A7A7D079A2475bA00bE92b52E39b4b
Body Params application/json
model
enum<string> 
required
必选。即梦模型ID,您需要调用的模型的 ID,不同模型支持不同的功能。您也可通过 Endpoint ID 来调用模型,获得限流、计费类型(前付费/后付费)、运行状态查询、监控、安全等高级能力。
Allowed values:
doubao-seedance-1-0-lite-i2v-250428doubao-seedance-1-0-lite-t2v-250428doubao-seedance-1-0-pro-250528
content
array[object (JimengContent) {4}] 
required
必选。输入给模型,生成视频的信息,支持文本信息和图片信息。
type
enum<string> 
required
必选。输入内容的类型
Allowed values:
textimage_url
text
string 
optional
文本提示词,描述希望生成的视频内容。可以在文本后追加模型文本命令,如 '--ratio 16:9 --duration 5'。仅当type为'text'时使用。
image_url
JimengImageUrl
optional
必选。输入给模型的图片对象。仅当type为'image_url'时使用。
role
enum<string> 
optional
条件必填。图片的位置或用途。当type为'image_url'时需要指定。
枚举值:
first_frame:首帧图片
last_frame:尾帧图片
注意:
当使用首尾帧图生视频功能时,需传入2个image_url对象,1个role为first_frame,另一个role为last_frame
传入的首尾帧图片可相同
首尾帧图片的宽高比不一致时,以首帧图片为主,尾帧图片会自动裁剪适配
当使用首帧图生视频功能时,role填写first_frame或不填
Allowed values:
first_framelast_frame
callback_url
string 
optional
可选。回调 URL,当视频生成完成后,火山引擎会将视频的 URL 通过该 URL 通知您。
Examples
{
    "model": "doubao-seedance-1-0-lite-t2v-250428",
    "content": [
        {
            "type": "text",
            "text": "日落下的城市,延时摄影 --ratio 16:9 --duration 5"
        }
    ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST '/v1/video/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seedance-1-0-lite-t2v-250428",
    "content": [
        {
            "type": "text",
            "text": "日落下的城市,延时摄影 --ratio 16:9 --duration 5"
        }
    ]
}'

Responses

🟢200OK
application/json
即梦视频生成任务提交成功
Body
taskId
string 
optional
生成任务ID
status
string 
optional
任务状态
Example
{
    "taskId": "string",
    "status": "string"
}
Modified at 2025-07-16 07:15:14
Previous
Veo3视频生成
Next
可灵视频生成
Built with