章鱼哥AI接口文档

Omni

通过文字、参考图或首尾帧生成视频。

本系列支持的端点
  • Omni创建POST https://zexapi.com/v1/videos
POSThttps://zexapi.com/v1/videos
鉴权 Authorization: Bearer YOUR_API_KEY

使用 API Key 进行 Bearer 鉴权。JSON 请求设置 Content-Type: application/json;Multipart 请求由客户端自动生成 boundary。

视频修改能力存在来源冲突,请先核对型号目录;不能按此页的素材数量推定当前型号支持传视频。
  • 素材 URL 必须直接返回文件内容,不能是网页或需要登录的地址。
  • omni_flash-10s 与 omni_flash-10s-fl 的规格不能直接套用到 HD 或 Omni 1.2 型号。

Omni 视频生成接口文档

接口地址

POST /v1/videos

功能说明

支持 Omni 系列模型的文生视频、图生视频和视频修改:
文生视频:不传图片,仅用提示词生成,使用 omni_flash-10s、omni_1_2_flash-10s 或 omni_1_2_flash-15s
图生视频(首尾帧模式):使用 omni_flash-10s-fl、omni_1_2_flash-10s-fl 或 omni_1_2_flash-15s-fl,支持 1~2 张图片作为首尾帧
图生视频(参考图模式):使用 omni_flash-10s、omni_1_2_flash-10s 或 omni_1_2_flash-15s,支持最多 7 张参考图片
视频修改:使用 omni_flash-10s、omni_1_2_flash-10s 或 omni_1_2_flash-15s。只允许传 1 个视频,不传图片。JSON 用 videos,表单用 input_reference,配合提示词对视频进行修改

当前可用模型

omni_flash-10s、omni_flash-10s-fl 对应官方 Gemini Omni Flash 1.1(官方模型名 gemini-omni-1.1-flash)。omni_1_2_flash-10s、omni_1_2_flash-10s-fl、omni_1_2_flash-15s、omni_1_2_flash-15s-fl 的字段用法与它们相同,时长由模型名中的 10s / 15s 决定。
模型名时长分辨率说明
omni_flash-10s10s720p文生 / 参考图 / 视频修改,横竖屏均支持
omni_flash-10s-fl10s720p首尾帧,横竖屏均支持
omni_1_2_flash-10s10s720p文生 / 参考图 / 视频修改,横竖屏均支持
omni_1_2_flash-10s-fl10s720p首尾帧,横竖屏均支持
omni_1_2_flash-15s15s720p文生 / 参考图 / 视频修改,横竖屏均支持
omni_1_2_flash-15s-fl15s720p首尾帧,横竖屏均支持
后续将陆续新增更多档位(更高分辨率、更长时长等),字段用法不变。

请求方式

支持两种方式,任选其一:
方式Content-Type素材字段
multipart/form-datamultipart/form-data图片和视频都使用可重复的 input_reference
application/jsonapplication/json图片用 images,视频用 videos。JSON 中不得使用 input_reference

请求头

参数名类型必填说明
Authorizationstring是Bearer YOUR_API_KEY
Content-Typestring是multipart/form-data 或 application/json,须与请求体一致

表单字段说明

参数名类型必填说明
modelstring是模型名称:文生 / 参考图 / 视频修改用 omni_flash-10s、omni_1_2_flash-10s 或 omni_1_2_flash-15s。首尾帧用 omni_flash-10s-fl、omni_1_2_flash-10s-fl 或 omni_1_2_flash-15s-fl
promptstring是文本提示词
sizestring否视频尺寸,固定枚举:1280x720(横屏)、720x1280(竖屏)
input_reference可重复否图生视频时同一字段名可重复多次,每项一张图片。视频修改时只传 1 个视频文件或视频 URL,不传图片。文生视频不传本字段。

input_reference 的传法

方式说明
本地文件(图片)multipart 里以文件部件提交,例如 -F "input_reference=@/path/to/image.jpg"
本地文件(视频)仅视频修改,只传 1 个。例如 -F "input_reference=@/path/to/video.mp4"。不要再传图片或其他视频
图片 URL以普通表单文本提交可公网访问的图片直链,例如 -F "input_reference=https://example.com/a.png"(勿传需登录的短链页面)
Base64以文本字段提交完整 data URI,例如 -F "input_reference=data:image/jpeg;base64,/9j/4AAQSkZJRg..."
传入图片 URL 时,网关会自动将其下载并转为 Base64 后发给上游,请确保 URL 为可公网访问的图片直链。
顺序约定:
首尾帧模式:第 1 个 input_reference 为首帧,第 2 个为尾帧;仅 1 个时表示只指定首帧。
参考图模式:按传入顺序作为参考图 1、2……7,最多 7 张。
视频修改:只传 1 个视频,不传图片。表单用 1 个 input_reference 传视频文件或视频 URL。

JSON 请求体说明(application/json)

参数名类型必填说明
modelstring是与表单一致:文生 / 参考图 / 视频修改用 omni_flash-10s、omni_1_2_flash-10s 或 omni_1_2_flash-15s。首尾帧用 omni_flash-10s-fl、omni_1_2_flash-10s-fl 或 omni_1_2_flash-15s-fl
promptstring是文本提示词
sizestring否视频尺寸,固定枚举:1280x720(横屏)、720x1280(竖屏)
imagesstring[]否只传图片(URL / Base64 data URI)。首尾帧 1~2 项;参考图最多 7 项。文生视频和视频修改不传或传 []。不要把视频放进 images
videosstring[]否只用于视频修改。只允许 1 个可公网访问的视频直链,不传图片,也不要再传 images。本地视频文件请改用表单 input_reference

images 每项取值

方式JSON images 数组元素
图片 URL"https://example.com/a.png"(须为可公网访问的图片直链)
Base64"data:image/jpeg;base64,/9j/4AAQSkZJRg..."(完整 data URI)
本地文件JSON 无法直接附带文件。图片请先编码为 data URI 写入 images;本地视频请改用表单 input_reference

videos 每项取值

方式JSON videos 数组元素
视频 URL"https://example.com/video.mp4"(只放 1 条可公网访问的视频直链,不传图片)
本地文件JSON 无法直接附带视频文件,请改用表单 input_reference

请求示例

文生视频(JSON)

curl -X POST "https://xxxxx.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni_flash-10s",
    "prompt": "一只可爱的小猫在花园里玩耍",
    "size": "1280x720"
  }'

文生视频(表单)

curl -X POST "https://xxxxx.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=omni_flash-10s" \
  -F "prompt=一只可爱的小猫在花园里玩耍" \
  -F "size=1280x720"

图生视频 · 首尾帧 · URL 传图(JSON)

curl -X POST "https://xxxxx.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni_flash-10s-fl",
    "prompt": "让这两张图之间自然过渡",
    "size": "1280x720",
    "images": [
      "https://example.com/first.png",
      "https://example.com/last.jpg"
    ]
  }'

图生视频 · 首尾帧 · 本地文件(表单)

curl -X POST "https://xxxxx.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=omni_flash-10s-fl" \
  -F "prompt=让这两张图之间自然过渡" \
  -F "size=1280x720" \
  -F "input_reference=@/path/to/first_frame.jpg" \
  -F "input_reference=@/path/to/last_frame.jpg"

图生视频 · 首尾帧 · 图片 URL(表单)

curl -X POST "https://xxxxx.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=omni_flash-10s-fl" \
  -F "prompt=让这两张图之间自然过渡" \
  -F "size=1280x720" \
  -F "input_reference=https://example.com/first.png" \
  -F "input_reference=https://example.com/last.jpg"

图生视频 · 参考图 · URL 传图(JSON)

curl -X POST "https://xxxxx.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni_flash-10s",
    "prompt": "根据参考图生成视频",
    "size": "1280x720",
    "images": [
      "https://example.com/image1.jpg",
      "https://example.com/image2.jpg",
      "https://example.com/image3.jpg"
    ]
  }'

图生视频 · 参考图 · URL 传图(表单)

curl -X POST "https://xxxxx.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=omni_flash-10s" \
  -F "prompt=根据参考图生成视频" \
  -F "size=1280x720" \
  -F "input_reference=https://example.com/image1.jpg" \
  -F "input_reference=https://example.com/image2.jpg" \
  -F "input_reference=https://example.com/image3.jpg"
Windows cmd 示例(curl.exe 使用 ^ 换行):
curl.exe -X POST "https://xxxxx.com/v1/videos" ^
  -H "Authorization: Bearer YOUR_API_KEY" ^
  -F "model=omni_flash-10s" ^
  -F "prompt=根据参考图生成视频" ^
  -F "size=1280x720" ^
  -F "input_reference=https://example.com/image1.jpg" ^
  -F "input_reference=https://example.com/image2.jpg"

图生视频 · 参考图 · 本地文件(表单,最多 7 张)

curl -X POST "https://xxxxx.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=omni_flash-10s" \
  -F "prompt=根据参考图生成视频" \
  -F "size=1280x720" \
  -F "input_reference=@/path/to/ref1.jpg" \
  -F "input_reference=@/path/to/ref2.jpg" \
  -F "input_reference=@/path/to/ref3.jpg"

Python 示例(表单)

import requests

url = "https://xxxxx.com/v1/videos"

headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

# multipart/form-data,图生视频示例
files = [
    ("model",  (None, "omni_flash-10s")),
    ("prompt", (None, "根据参考图生成视频")),
    ("size",   (None, "1280x720")),

    # 最多 7 张参考图,每张一个 input_reference
    ("input_reference", (None, "https://example.com/image1.jpg")),
    ("input_reference", (None, "https://example.com/image2.jpg")),
    ("input_reference", (None, "https://example.com/image3.jpg")),
]

response = requests.post(url, headers=headers, files=files)
print(response.status_code)
print(response.text)

视频修改 · 视频 URL(JSON)

curl -X POST "https://xxxxx.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni_flash-10s",
    "prompt": "把镜头节奏放慢,并改成黄昏光线",
    "size": "1280x720",
    "videos": [
      "https://example.com/source.mp4"
    ]
  }'

视频修改 · 本地视频文件(表单)

curl -X POST "https://xxxxx.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=omni_flash-10s" \
  -F "prompt=把镜头节奏放慢,并改成黄昏光线" \
  -F "size=1280x720" \
  -F "input_reference=@/path/to/source.mp4"

响应参数

完成态视频地址位于顶层 url 和 video_url,两者值相同。
参数名类型说明
idstring任务 ID
objectstring固定值:video
modelstring实际使用的模型名称
statusstring任务状态:queued(排队中)、in_progress(处理中)、completed(已完成)、failed(失败)
progressnumber任务进度,0~100
created_atnumber创建时间戳(秒)
completed_atnumber完成时间戳(秒,仅 completed 状态返回)
sizestring视频尺寸:1280x720(横屏)或 720x1280(竖屏)
urlstring视频直链(仅 completed)
video_urlstring与 url 同值(仅 completed)
errorobject错误信息(仅 failed 状态返回),含 message、code 字段

响应示例

任务处理中

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "omni_flash-10s",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1709876543,
  "size": "1280x720"
}

提交成功(排队中)

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "omni_flash-10s",
  "status": "queued",
  "progress": 0,
  "created_at": 1709876543,
  "size": "1280x720"
}

任务完成

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "omni_flash-10s",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876600,
  "size": "1280x720",
  "url": "https://example.com/output.mp4",
  "video_url": "https://example.com/output.mp4"
}

任务失败

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "omni_flash-10s",
  "status": "failed",
  "progress": 0,
  "created_at": 1709876543,
  "error": {
    "code": "content_policy_violation",
    "message": "内容违反使用政策"
  }
}

查询任务状态

接口地址

GET /v1/videos/{task_id}

请求示例

curl -X GET "https://xxxxx.com/v1/videos/task_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应参数与提交接口相同,completed 后读取顶层 url 或 video_url。

注意事项

1.
模型名即完整规格:模型名中已包含时长和分辨率信息(如 omni_flash-10s 表示 flash 质量 10 秒 720p)。omni_flash-10s / omni_flash-10s-fl 对应官方 Gemini Omni Flash 1.1(gemini-omni-1.1-flash)。omni_1_2_flash-10s、omni_1_2_flash-15s 同 omni_flash-10s,用于文生 / 参考图 / 视频修改;omni_1_2_flash-10s-fl、omni_1_2_flash-15s-fl 用于首尾帧。请求字段与对应的 omni_flash 模型相同,只需更换 model。
2.
size 尺寸参数(固定枚举,仅以下两个值):
1280x720:横屏
720x1280:竖屏
3.
模型选择:
文生视频:omni_flash-10s、omni_1_2_flash-10s 或 omni_1_2_flash-15s;表单不传 input_reference;JSON 不传 images 或 images: []
首尾帧:omni_flash-10s-fl、omni_1_2_flash-10s-fl 或 omni_1_2_flash-15s-fl,1~2 张图;表单用 input_reference,JSON 用 images
参考图:omni_flash-10s、omni_1_2_flash-10s 或 omni_1_2_flash-15s,最多 7 张图;表单用 input_reference,JSON 用 images
视频修改:omni_flash-10s、omni_1_2_flash-10s 或 omni_1_2_flash-15s。只允许 1 个视频,不传图片。JSON 用 videos;表单用 1 个 input_reference
4.
数量上限:参考图最多 7 张。视频修改只允许 1 个视频,不传图片;多传的视频或图片会被忽略或报错。文件数量越多、单个文件越大,上传耗时越长,请耐心等待。
5.
视频修改传参规则:只接受 1 个视频,不接受图片,也不能和图混传。JSON 的 videos 只放 1 条可公网访问的视频直链;表单只传 1 个 input_reference(本地视频文件或视频 URL)。不要把视频放进 images。JSON 不能直接附带视频文件,本地视频请使用表单。
6.
JSON 与表单二选一:application/json 时图片用 images,视频用 videos,不要写 input_reference。multipart/form-data 时图片用可重复的 input_reference;视频修改只传 1 个 input_reference。
7.
图片/视频 URL 要求:须为直链(直接返回文件二进制内容),不要传网页 HTML 地址或需要登录才能访问的链接。
8.
异步接口:提交成功仅返回任务 ID,需轮询 GET /v1/videos/{task_id}。queued / in_progress 继续等;completed 读取顶层 url 或 video_url;failed 读 error.message。

接口地址

POST /v1/videos

视频调试参数说明

先选择生成方式,再选择型号。参考图片与首尾帧为独立用法,切换用法后显示对应素材输入。JSON 使用 images 数组;表单使用重复的 input_reference 文件字段。