omni视频接入

本页说明如何接入 We-AI 的 Omni Flash 视频生成服务。当前协议为 100% OpenAI 兼容协议，仅包含 Omni 系列 9 个模型。

接口说明

创建视频使用 POST /v1/videos，查询任务使用 GET /v1/videos/{task_id}，下载结果使用 GET /v1/videos/{task_id}/content。

视频站点地址 / Base URL 统一为：https://video.we-token.cc/。

一、接入前准备

调用前请准备：

视频站点地址：https://video.we-token.cc/
We-AI API Base URL。
We-AI API Key。
可公开访问的图片或视频地址；多图参考与视频编辑都依赖媒体 URL 或等价上传能力。
视频提示词、时长和画幅比例。

请求头使用：

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

不要把真实 API Key 写进前端代码、公开仓库、截图或聊天记录。

二、接口信息

项	值
视频站点地址	`https://video.we-token.cc/`
API Base URL	`https://video.we-token.cc/`
认证方式	`Authorization: Bearer <API_KEY>`
创建视频	`POST /v1/videos`
查询任务	`GET /v1/videos/{task_id}`
下载视频	`GET /v1/videos/{task_id}/content`

Base URL 说明

如果你的客户端要求单独配置 baseURL，通常再拼上 /v1，即 https://video.we-token.cc/v1。

三、模型说明

3.1 基础文生视频

模型	说明
`omni-flash`	基础版
`omni-flash-1080p`	1080p
`omni-flash-4k`	4K

3.2 多图参考（r2v）

模型	说明
`omni-flash-components`	多图参考，基础版
`omni-flash-components-1080p`	多图参考，1080p
`omni-flash-components-4k`	多图参考，4K

3.3 视频编辑

模型	说明
`omni-flash-edit`	视频编辑，基础版
`omni-flash-edit-1080p`	视频编辑，1080p
`omni-flash-edit-4k`	视频编辑，4K

调用时注意：

model 必须传完整模型名。
seconds 仅支持 4、6、8、10，字符串或数字均可。
aspect_ratio 仅支持 16:9 或 9:16。
image 适合单图输入；images 适合多图输入；input_video 适合视频编辑。

四、请求参数

创建视频使用 application/json。

基础字段

字段	类型	必填	说明
`model`	string	是	模型名
`prompt`	string	是	视频描述
`seconds`	string / int	是	视频时长，仅支持 `4`、`6`、`8`、`10`
`aspect_ratio`	string	否	画幅比例，仅支持 `16:9` / `9:16`

Omni 专属字段

字段	类型	说明
`image`	string	单图输入，适用于 `omni-flash-components*`
`images`	array	多图输入，适用于 `omni-flash-components*`
`input_video`	string	输入视频，适用于 `omni-flash-edit*`

五、请求示例

5.1 文生视频

bash

curl -X POST "<BASE_URL>/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-flash",
    "prompt": "A cute gray cat walks slowly across a sunny wooden floor and looks at the camera.",
    "seconds": "4",
    "aspect_ratio": "16:9"
  }'

5.2 图生视频（单图 / 多图）

单图：

bash

curl -X POST "<BASE_URL>/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-flash-components",
    "prompt": "Animate this cat taking one small step forward and blinking naturally.",
    "seconds": "4",
    "aspect_ratio": "16:9",
    "image": "data:image/png;base64,..."
  }'

多图：

bash

curl -X POST "<BASE_URL>/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-flash-components",
    "prompt": "Create a cute short animation where the puppy and the gray cat meet in a sunny garden and become friends.",
    "seconds": "4",
    "aspect_ratio": "16:9",
    "images": [
      "data:image/png;base64,...",
      "data:image/png;base64,..."
    ]
  }'

5.3 视频编辑

bash

curl -X POST "<BASE_URL>/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-flash-edit",
    "prompt": "Make the cat gently turn its head and blink once, keeping the same style.",
    "seconds": "4",
    "aspect_ratio": "16:9",
    "input_video": "https://example.com/source.mp4"
  }'

六、任务处理流程

视频生成是异步任务，通常按以下流程处理：

提交视频生成请求。
保存接口返回的任务 ID。
使用任务 ID 查询任务状态。
任务完成后读取视频下载地址。
任务失败、取消或超时时，停止轮询并处理错误。

常见状态包括：

状态	含义
`queued`	已进入队列
`in_progress`	正在生成
`completed`	生成完成
`failed`	生成失败

建议每 3 至 5 秒查询一次，不要高频轮询。客户端还应设置最大等待时间，并使用自己的 request_id 防止网络重试造成重复任务。

七、返回结果

7.1 创建任务成功

json

{
  "id": "task_xxxxx",
  "task_id": "task_xxxxx",
  "object": "video",
  "model": "omni-flash",
  "status": "queued",
  "progress": 0,
  "created_at": 1785343043,
  "seconds": "4",
  "size": "1280x720"
}

7.2 任务查询

bash

curl "<BASE_URL>/v1/videos/task_xxxxx" \
  -H "Authorization: Bearer <API_KEY>"

7.3 视频下载

任务完成后，直接下载：

bash

curl -L -o output.mp4 "<BASE_URL>/v1/videos/task_xxxxx/content" \
  -H "Authorization: Bearer <API_KEY>"

八、客户端接入

客户端	配置
OpenAI Python SDK	`OpenAI(base_url="<BASE_URL>/v1", api_key="<API_KEY>")`
openai-node	`new OpenAI({ baseURL, apiKey })`
LangChain	`ChatOpenAI(openai_api_base=..., openai_api_key=...)`
Vercel AI SDK	`createOpenAI({ baseURL, apiKey })`
Cursor / Cline / Continue	Provider = OpenAI Compatible

九、接入检查清单

正式接入前，建议依次验证：

API Key 已通过 Authorization: Bearer <API_KEY> 传递。
model 已填写完整模型名称，没有使用缩写。
seconds 仅使用 4、6、8、10。
aspect_ratio 仅使用 16:9 或 9:16。
image、images 只用于多图参考模型。
input_video 只用于视频编辑模型。
创建、查询、下载这 3 个接口都已打通。
客户端保存任务 ID，并按合理间隔查询任务状态。
任务失败或超时时能够停止轮询并展示明确错误。

omni视频接入 ​

一、接入前准备 ​

二、接口信息 ​

三、模型说明 ​

3.1 基础文生视频 ​

3.2 多图参考（r2v） ​

3.3 视频编辑 ​

四、请求参数 ​

基础字段 ​

Omni 专属字段 ​

五、请求示例 ​

5.1 文生视频 ​

5.2 图生视频（单图 / 多图） ​

5.3 视频编辑 ​

六、任务处理流程 ​

七、返回结果 ​

7.1 创建任务成功 ​

7.2 任务查询 ​

7.3 视频下载 ​

八、客户端接入 ​

九、接入检查清单 ​

omni视频接入

一、接入前准备

二、接口信息

三、模型说明

3.1 基础文生视频

3.2 多图参考（r2v）

3.3 视频编辑

四、请求参数

基础字段

Omni 专属字段

五、请求示例

5.1 文生视频

5.2 图生视频（单图 / 多图）

5.3 视频编辑

六、任务处理流程

七、返回结果

7.1 创建任务成功

7.2 任务查询

7.3 视频下载

八、客户端接入

九、接入检查清单