1. 视频生成（Videos）
小扳手AI接口文档
  • 图片生成（Images）
    • nano banana接口
      POST
    • nano banana接口Gemini 原生格式
      POST
    • GPT-image2图片同步接口
      POST
    • GPT-image2异步接口格式
      POST
  • 视频生成（Videos）
    • sora创建
      POST
    • Omni创建
      POST
    • veo视频接口
      POST
    • 视频+图片任务查询
      GET
  • 失效接口
    • sora去水印接口
      POST
    • sora视频接口
      POST
    • veo15s视频接口
      POST
    • Veo 视频延长（Remix）接口
      POST
  1. 视频生成（Videos）

Omni创建

开发中
POST
https://xibapi.com/v1/videos

Omni 视频生成接口文档#

接口地址#

POST /v1/videos

功能说明#

支持 Omni 系列模型的文生视频、图生视频和视频修改：
文生视频：不传图片，仅用提示词生成，使用 omni_flash-10s
图生视频（首尾帧模式）：使用 omni_flash-10s-fl，支持 1～2 张图片作为首尾帧
图生视频（参考图模式）：使用 omni_flash-10s，支持最多 7 张参考图片
视频修改：将视频文件或视频 URL 通过图片字段传入（表单用 input_reference 传文件，JSON 用 images 传 URL），配合提示词对视频进行修改

当前可用模型#

当前接口模型对应官方 Gemini Omni Flash 1.1（官方模型名 gemini-omni-1.1-flash）：
模型名时长分辨率说明
omni_flash-10s10s720p文生 / 参考图 / 视频修改，横竖屏均支持
omni_flash-10s-fl10s720p首尾帧，横竖屏均支持
后续将陆续新增更多档位（更高分辨率、更长时长等），字段用法不变。

请求方式#

支持两种方式，任选其一：
方式Content-Type图生视频时的图片字段
multipart/form-datamultipart/form-data使用 input_reference（可重复字段，每张图一个字段）
application/jsonapplication/json使用 images（字符串数组，每项对应一张图）；不得在 JSON 中使用 input_reference

请求头#

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

表单字段说明#

参数名类型必填说明
modelstring是模型名称：文生 / 参考图 / 视频修改用 omni_flash-10s；首尾帧用 omni_flash-10s-fl
promptstring是文本提示词
sizestring否视频尺寸，固定枚举：1280x720（横屏）、720x1280（竖屏）
input_reference可重复否图生视频或视频修改时传递，同一字段名可重复多次，每次对应一张图或一个视频文件。文生视频不传本字段。传视频文件时，以本地文件方式提交视频，配合提示词对其进行修改。

input_reference 的传法#

方式说明
本地文件（图片）multipart 里以文件部件提交，例如 -F "input_reference=@/path/to/image.jpg"
本地文件（视频）multipart 里以文件部件提交视频，例如 -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 张。

JSON 请求体说明（application/json）#

参数名类型必填说明
modelstring是与表单一致：文生 / 参考图 / 视频修改用 omni_flash-10s；首尾帧用 omni_flash-10s-fl
promptstring是文本提示词
sizestring否视频尺寸，固定枚举：1280x720（横屏）、720x1280（竖屏）
imagesstring[]否图生视频或视频修改时传：每项为一张图或一个视频（URL / Base64 data URI）。首尾帧 1～2 项；参考图最多 7 项。修改视频时传视频 URL（不支持直接传视频文件，须使用可公网访问的视频直链）。文生视频不传或传 []。禁止使用 input_reference。多图顺序约定与表单相同（首尾帧：第 1、2 张为首尾；参考图：最多 7 张）。

images 每项取值#

方式JSON images 数组元素
图片 URL"https://example.com/a.png"（须为可公网访问的图片直链）
视频 URL"https://example.com/video.mp4"（须为可公网访问的视频直链，用于视频修改）
Base64"data:image/jpeg;base64,/9j/4AAQSkZJRg..."（完整 data URI）
本地文件JSON 无法直接附带文件，请先读取为字节后编码为 data URI 字符串写入 images；视频修改建议改用表单方式传本地视频文件

请求示例#

文生视频（JSON）#

文生视频（表单）#

图生视频 · 首尾帧 · URL 传图（JSON）#

图生视频 · 首尾帧 · 本地文件（表单）#

图生视频 · 首尾帧 · 图片 URL（表单）#

图生视频 · 参考图 · URL 传图（JSON）#

图生视频 · 参考图 · URL 传图（表单）#

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 张）#

Python 示例（表单）#

响应参数#

参数名类型说明
idstring任务 ID
objectstring固定值：video
modelstring实际使用的模型名称
statusstring任务状态：queued（排队中）、processing（处理中）、completed（已完成）、failed（失败）
progressnumber任务进度，0～100
created_atnumber创建时间戳（秒）
completed_atnumber完成时间戳（秒，仅 completed 状态返回）
sizestring视频尺寸：1280x720（横屏）或 720x1280（竖屏）
video_urlstring视频直链（仅 completed 状态返回）
errorobject错误信息（仅 failed 状态返回），含 message、code 字段

响应示例#

提交成功（排队中）#

{
  "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",
  "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}

请求示例#

响应参数与提交接口相同，completed 后会包含 video_url。

注意事项#

1.
模型名即完整规格：模型名中已包含时长和分辨率信息（如 omni_flash-10s 表示 flash 质量 10 秒 720p）。对应官方模型为 Gemini Omni Flash 1.1（gemini-omni-1.1-flash），调用时仍使用本文档中的 omni_flash-10s / omni_flash-10s-fl。
2.
size 尺寸参数（固定枚举，仅以下两个值）：
1280x720：横屏
720x1280：竖屏
3.
模型选择：
文生视频：omni_flash-10s；表单不传 input_reference；JSON 不传 images 或 images: []
首尾帧：omni_flash-10s-fl，1～2 张图；表单用 input_reference，JSON 用 images
参考图：omni_flash-10s，最多 7 张图；表单用 input_reference，JSON 用 images
视频修改：omni_flash-10s，传入视频文件或视频 URL
4.
参考图/视频上限为 7 项：参考图或视频修改时，input_reference（表单）或 images（JSON）最多传 7 项，超出部分会被忽略或报错。文件数量越多、单个文件越大，上传耗时越长，请耐心等待。
5.
视频修改传参规则：表单（multipart/form-data）用 input_reference 传本地视频文件；JSON（application/json）用 images 传视频 URL（须为可公网访问的视频直链）。不支持在 JSON 中直接附带视频文件，如需传本地视频请使用表单方式。
6.
JSON 与表单二选一：application/json 时图片必须用 images 数组，不要写 input_reference；multipart/form-data 时用重复的 input_reference 字段。
7.
图片/视频 URL 要求：须为直链（直接返回文件二进制内容），不要传网页 HTML 地址或需要登录才能访问的链接。
8.
异步接口：提交成功仅返回任务 ID，需轮询 GET /v1/videos/{task_id} 获取进度与结果。

请求参数

Header 参数

Body 参数application/json必填

示例
{
  "model": "omni_flash-10s",
  "prompt": "广告",
  "size": "1280x720",
  "images": [
    "https://xxxxxxxx.jpg",
    "https://xxxxxxxx.png"
  ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://xibapi.com/v1/videos' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "model": "omni_flash-10s",
  "prompt": "广告",
  "size": "1280x720",
  "images": [
    "https://xxxxxxxx.jpg",
    "https://xxxxxxxx.png"
  ]
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "veo_3_1-fast",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876600,
  "size": "1920x1080"
}
修改于 2026-08-28 10:45:43
上一页
sora创建
下一页
veo视频接口
Built with