curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-omni-1.1-flash-image-to-video",
"prompt": "让画面中的人物缓缓转头微笑，背景树叶随风轻摆",
"image_urls": [
"https://example.com/portrait.jpg"
],
"quality": "720p",
"aspect_ratio": "16:9",
"duration": 3
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "gemini-omni-1.1-flash-image-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "processing",
"task_info": {
"can_cancel": false,
"estimated_time": 60,
"video_duration": 3
},
"type": "video",
"usage": {
"billing_rule": "per_token",
"credits_reserved": 102.34,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: gemini-omni-1.1-flash-image-to-video",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Gemini Omni 1.1 Flash
Gemini Omni 1.1 Flash 图生视频
- Gemini Omni 1.1 Flash (gemini-omni-1.1-flash-image-to-video) 模型支持图生视频模式，基于输入图像与文本提示词生成一段带原生音频的视频
- 首尾帧输入：
image_urls为首尾帧图片数组，支持 1~2 张；传 1 张时作为首帧，传 2 张时第 1 张为首帧、第 2 张为尾帧 - 首尾帧： 传 2 张图时，模型以第 1 张为起始画面、第 2 张为结束画面生成过渡视频；尾帧不能单独传
- 分辨率： 通过
quality选择360p、720p、1080p或4k，默认720p - 时长控制： 通过
duration指定3~10秒的整数时长，默认为3秒 - 画面比例： 通过
aspect_ratio选择16:9、9:16或auto，默认auto - 原生音频： 模型自动为画面生成同步音频，无需额外参数
- 负面描述： 直接写入
prompt（如No dialogue），本模型不提供独立的负面提示词参数 - 异步处理模式，使用返回的任务ID 进行查询
- 生成的视频链接，有效期为24小时，请尽快保存
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-omni-1.1-flash-image-to-video",
"prompt": "让画面中的人物缓缓转头微笑，背景树叶随风轻摆",
"image_urls": [
"https://example.com/portrait.jpg"
],
"quality": "720p",
"aspect_ratio": "16:9",
"duration": 3
}
'{
"created": 1757169743,
"id": "task-unified-1757169743-7cvnl5zw",
"model": "gemini-omni-1.1-flash-image-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "processing",
"task_info": {
"can_cancel": false,
"estimated_time": 60,
"video_duration": 3
},
"type": "video",
"usage": {
"billing_rule": "per_token",
"credits_reserved": 102.34,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: gemini-omni-1.1-flash-image-to-video",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}授权
##所有接口均需要使用Bearer Token进行认证##
获取 API Key ：
访问 API Key 管理页面 获取您的 API Key
使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY
请求体
application/json
模型名称，固定为 gemini-omni-1.1-flash-image-to-video
可用选项:
gemini-omni-1.1-flash-image-to-video 示例:
"gemini-omni-1.1-flash-image-to-video"
视频生成的文本提示词，支持中英文
使用建议：
- 描述画面主体的动作、镜头运动、氛围变化等，越具体效果越稳定
- 负面要求直接写入提示词（例如
No dialogue、不要出现文字），本模型不提供独立的负面提示词参数
示例:
"让画面中的人物缓缓转头微笑，背景树叶随风轻摆"
首尾帧图片数组，支持 1~2 张
首尾帧规则：
- 传 1 张：该图作为视频的首帧
- 传 2 张：第 1 张为首帧、第 2 张为尾帧，模型生成两帧之间的过渡画面
注意： 尾帧必须与首帧同时提供，不能只传尾帧
支持形式：
- HTTP/HTTPS 图片 URL
格式要求： 支持 png、jpeg、webp
Required array length:
1 - 2 elements示例:
[
"https://example.com/first-frame.jpg",
"https://example.com/last-frame.jpg"
]
视频分辨率，默认为 720p
可选值：
360p：横屏 640×360 / 竖屏 360×640720p：横屏 1280×720 / 竖屏 720×1280，此为默认值1080p：横屏 1920×1080 / 竖屏 1080×19204k：横屏 3840×2160 / 竖屏 2160×3840
方向由 aspect_ratio 决定：16:9 出横屏、9:16 出竖屏。
计费说明： 视频按输出 token 计费，token 数随分辨率线性增长——以 720p 为基准，360p 约为其 1/3、1080p 约为 1.5 倍、4k 约为 3 倍。实际扣费以生成视频的用量为准
可用选项:
360p, 720p, 1080p, 4k 示例:
"720p"
视频时长（秒），默认为 3 秒
说明：
- 支持
3–10秒之间的任意整数值 - 时长与计费直接相关
必填范围:
3 <= x <= 10示例:
3
视频宽高比，默认为 auto
取值说明：
16:9：横向画面9:16：竖向画面auto：由模型根据提示词和输入素材决定画面比例，此为默认值
可用选项:
16:9, 9:16, auto 示例:
"auto"
任务完成后的HTTPS回调地址
回调时机：
- 任务完成（completed）、失败（failed）或取消（cancelled）时触发
- 在计费确认完成后发送
安全限制：
- 仅支持HTTPS协议
- 禁止回调到内网IP地址（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x等）
- URL长度不超过
2048字符
回调机制：
- 超时时间：
10秒 - 失败后最多重试
3次（会分别在失败的1秒/2秒/4秒后进行重试） - 回调响应体格式与任务查询接口返回的格式一致
- 回调地址若返回2xx状态码视为成功，其他状态码会触发重试
示例:
"https://your-domain.com/webhooks/video-task-completed"
响应
视频任务创建成功
任务创建时间戳
示例:
1757169743
任务ID
示例:
"task-unified-1757169743-7cvnl5zw"
实际使用的模型名称
示例:
"gemini-omni-1.1-flash-image-to-video"
任务的具体类型
可用选项:
video.generation.task 任务进度百分比 (0-100)
必填范围:
0 <= x <= 100示例:
0
任务状态。创建接口恒返回 processing（内部 pending 状态对客户端统一投影为 processing）
可用选项:
pending, processing, completed, failed 示例:
"processing"
视频任务详细信息
Show child attributes
Show child attributes
任务的输出类型
可用选项:
text, image, audio, video 示例:
"video"
使用量和计费信息
Show child attributes
Show child attributes