Omni-Flash-Ext

POST

tasks

Omni-Flash-Ext

curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "image_urls": [
    "<string>"
  ],
  "video_urls": [
    "<string>"
  ],
  "generation_type": "<string>"
}
'

import requests

url = "https://www.qingbo.dev/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "image_urls": ["<string>"],
    "video_urls": ["<string>"],
    "generation_type": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    image_urls: ['<string>'],
    video_urls: ['<string>'],
    generation_type: '<string>'
  })
};

fetch('https://www.qingbo.dev/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.qingbo.dev/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"generation_type\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.qingbo.dev/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"generation_type\": \"<string>\"\n}")
  .asString();

omni-flash-ext 是 Omni 系列里时长可控的一档：duration 取 4 / 6 / 8 / 10 秒，输出 360p 到 4K，可以只给提示词，也可以用一张首帧图、三张参考图，或一段参考视频作为素材。需要模型自己决定时长、或者要多轮接着改同一段视频时，用 Gemini Omni Flash。

快速开始

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: omni-ext-001" \
  -d '{
    "model": "omni-flash-ext",
    "action": "generate",
    "prompt": "海面上的日落，海鸥掠过水面，电影感光影",
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-flash-ext",
    "action": "generate",
    "prompt": "人物微笑并缓缓转身，镜头轻微推近",
    "generation_type": "frame",
    "image_urls": ["https://cdn.example.com/character.jpg"],
    "duration": 6,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-flash-ext",
    "action": "generate",
    "prompt": "把三张图里的场景、人物和产品组合成一个连贯镜头",
    "generation_type": "reference",
    "image_urls": [
      "https://cdn.example.com/scene.jpg",
      "https://cdn.example.com/character.jpg",
      "https://cdn.example.com/product.jpg"
    ],
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-flash-ext",
    "action": "generate",
    "prompt": "同样的场景，改成霓虹灯下的夜景",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "video_urls": ["https://cdn.example.com/reference.mp4"]
  }'

提交成功后返回 task_id。用 GET /v1/tasks/{task_id} 查询结果，也可以用 Prefer: wait 在一次调用里等待，或配置 Webhook。

请求参数

string

必填

固定为 omni-flash-ext。

string

默认值:"generate"

取值 generate，可以省略。生成模式不靠 action 区分，靠传入的素材：只给 prompt 是文生视频，带 image_urls 是图生视频，带 video_urls 是参考视频改写。

string

必填

视频描述文本。描述场景、主体、动作、环境、镜头运动与视觉风格越具体，结果越稳定。

integer

默认值:"6"

视频时长（秒），取值 4、6、8、10。带 video_urls 时不要传这个字段，时长由参考视频决定。

string

默认值:"720p"

输出分辨率：360p、720p、1080p 或 4k，大小写不敏感。

string

默认值:"16:9"

画面比例：16:9 横版或 9:16 竖版。带 video_urls 时输出通常跟随参考视频的比例。

string[]

参考图片 URL 数组，需公网可访问。可以不传、传 1 张，或传 3 张；张数与 generation_type 的对应关系见「限制」。与 video_urls 可以同时传：图片作为形象或构图参考，视频作为运动参考。

string[]

参考视频 URL 数组，需公网可下载的直链。最多 1 条，最长 10 秒。传入时不要再传 duration。

string

图片用法：frame 首帧（限 1 张）/ reference 参考图（1 或 3 张）。

通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。本模型不支持 seed、first_frame_image、last_frame_image 和 ref_task_id；首帧图用 generation_type: "frame" 加一张 image_urls 表达。以上之外的参数会返回 400，不计费。

限制

每次任务只生成一个视频；图片 0、1 或 3 张（2 张会被上游拒绝）。
generation_type=frame 时恰好 1 张图片作为首帧。
generation_type=reference 时 1 或 3 张参考图。
带参考视频时不能传 duration（省略即可），最多 1 条、≤10 秒；按参考视频秒数计费。

项目	上限
参考图	最多 3 张
参考视频	最多 1 条，最长 10 秒
时长	`4` / `6` / `8` / `10` 秒
分辨率	`360p` / `720p` / `1080p` / `4k`
画面比例	`16:9` / `9:16`

计费

不带参考视频时，按分辨率 × 时长档的整片价计费：resolution 与 duration 是仅有的两个计费维度，四档分辨率与四档时长的每种组合各一个价，提交前即可确定单次费用。参考图不额外收费。 带参考视频（video_urls）时换一种收法：按参考视频的秒数计费，输出整片价不再收取。每档分辨率有各自的每秒单价，参考视频最长 10 秒。参考视频秒数如何取整见视频生成概述。提交任务时冻结一笔额度，任务完成后按实际生成结果结算，差额退回。只有成功生成视频才计费。任务失败、取消，或没有返回可用视频时，全额退款。最终费用以任务响应里的 cost 为准——整数 quota，500,000 quota = 1 USD，不是美元。

各模型的单价见 GET /v1/models 返回的 price_config，或控制台「模型市场」。本节只说明计费维度与口径，不列具体金额。

响应

任务完成

{
  "task_id": "taski-f4df1815445069da8995fa77f7cfc947-task-wave1788784802b950097545",
  "model": "omni-flash-ext",
  "action": "generate",
  "status": "completed",
  "progress": "100%",
  "created_at": 1788784802,
  "completed_at": 1788784868,
  "result": {
    "videos": [
      {
        "expires_at": 1789089508,
        "url": ["https://cdn.example.com/result.mp4"]
      }
    ]
  },
  "billing_status": "settled",
  "cost": 67500,
  "urls": {
    "get": "https://www.qingbo.dev/v1/tasks/{task_id}",
    "cancel": "https://www.qingbo.dev/v1/tasks/{task_id}/cancel"
  }
}

result.videos 返回生成的视频，url 是数组，expires_at 是链接过期时间（秒级时间戳）。完整字段说明见查询任务状态。

相关文档

Omni-Flash-Ext

curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "image_urls": [
    "<string>"
  ],
  "video_urls": [
    "<string>"
  ],
  "generation_type": "<string>"
}
'

import requests

url = "https://www.qingbo.dev/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "image_urls": ["<string>"],
    "video_urls": ["<string>"],
    "generation_type": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    image_urls: ['<string>'],
    video_urls: ['<string>'],
    generation_type: '<string>'
  })
};

fetch('https://www.qingbo.dev/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.qingbo.dev/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"generation_type\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.qingbo.dev/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"generation_type\": \"<string>\"\n}")
  .asString();

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

账户与用量

快速开始

请求参数

限制

计费

响应

相关文档

​快速开始

​请求参数

​限制

​计费

​响应

​相关文档

快速开始

请求参数

限制

计费

响应

相关文档