Omni-Flash-Ext

POST

tasks

Omni-Flash-Ext

curl --request POST \
  --url https://api.qingbo.ai/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://api.qingbo.ai/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://api.qingbo.ai/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://api.qingbo.ai/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://api.qingbo.ai/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 is the Omni model whose length you control: duration is 4, 6, 8 or 10 seconds, output runs from 360p to 4K, and the input can be a prompt alone, one first-frame image, 1 or 3 reference images fused into one scene, or one reference video of up to 10 seconds used as a motion reference (optionally with images as identity or composition references). When the model should pick the length itself, or you want to keep editing the same clip over several rounds, use Gemini Omni Flash.

Quick start

curl -X POST https://api.qingbo.ai/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": "sunset over the sea, gulls skimming the water, cinematic light",
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-flash-ext",
    "action": "generate",
    "prompt": "the character smiles and slowly turns around, gentle push-in",
    "generation_type": "frame",
    "image_urls": ["https://cdn.example.com/character.jpg"],
    "duration": 6,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-flash-ext",
    "action": "generate",
    "prompt": "combine the scene, the character and the product into one continuous shot",
    "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://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omni-flash-ext",
    "action": "generate",
    "prompt": "the same scene, shot at night under neon lights",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "video_urls": ["https://cdn.example.com/reference.mp4"]
  }'

A successful submission returns a task_id. Retrieve the result with GET /v1/tasks/{task_id}, wait inline with Prefer: wait, or configure a webhook.

Request parameters

string

required

Must be omni-flash-ext.

string

default:"generate"

Value generate; it may be omitted. The mode is not selected with action but by what you send: prompt alone is text-to-video, image_urls makes it image-to-video or reference fusion, and video_urls uses a reference video as motion reference.

string

required

The video description: scene, subject, action, setting, camera movement and visual style.

integer

default:"6"

Clip length in seconds: 4, 6, 8 or 10.Do not send this field together with video_urls — the reference video determines the length.

string

default:"720p"

Output resolution: 360p, 720p, 1080p or 4k, case-insensitive.

string

default:"16:9"

Frame ratio: 16:9 landscape or 9:16 portrait. With video_urls, the output usually follows the reference video’s ratio.

string[]

Reference image URLs, publicly accessible. Send none, one, or three; how the count maps to generation_type is under “Limits”.It can be combined with video_urls: the images act as identity or composition references while the video acts as the motion reference.

string[]

Reference video URLs, publicly downloadable direct links. At most one clip, up to 10 seconds. Do not send duration alongside it.

string

How images are used: frame (exactly 1) or reference (1 or 3).

See Submit Task for callback_url, callback_events, Prefer: wait, Idempotency-Key, and the maximum-cost header. This model does not support seed, first_frame_image, last_frame_image or ref_task_id; a first frame is expressed as generation_type: "frame" with one image in image_urls. Any other parameter returns 400 and is not billed.

Limits

One video per task; 0, 1 or 3 images (2 images are rejected upstream).
generation_type=frame takes exactly one image as the first frame.
generation_type=reference takes 1 or 3 reference images.
With a reference video duration cannot be sent (omit it); at most one video of ≤ 10 s, billed per second of the reference video.

Item	Limit
Reference images	Up to 3
Reference video	At most 1, up to 10 seconds
Duration	`4` / `6` / `8` / `10` seconds
Resolution	`360p` / `720p` / `1080p` / `4k`
Aspect ratio	`16:9` / `9:16`

Pricing

Without a reference video, billing is a whole-clip price by resolution × duration: resolution and duration are the only two billing dimensions, every combination of the four resolutions and four durations has its own price, and the cost of a call is known before you submit it. Reference images cost nothing extra. With a reference video (video_urls) the shape changes: billing runs per second of the reference video and the whole-clip price is not charged. Each resolution tier has its own per-second rate, and a reference video may be at most 10 seconds. How reference-video seconds are rounded is covered in Video Generation Overview. Submitting a task places a hold; the task then settles on the actual generated result and the difference is released. You are only billed for a successfully generated video. Failed and cancelled tasks, and tasks that return no usable video, are refunded in full. What a call actually cost is the cost field on the task response — an integer quota at 500,000 quota = 1 USD, not dollars.

Per-model rates are in price_config on GET /v1/models and in the console’s Model Market.This section describes the billing dimensions only; it carries no amounts.

Response

Completed task

{
  "task_id": "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://api.qingbo.ai/v1/tasks/{task_id}",
    "cancel": "https://api.qingbo.ai/v1/tasks/{task_id}/cancel"
  }
}

The generated video is returned in result.videos, where url is an array and expires_at is the link’s expiry as a Unix timestamp in seconds. See Query Task Status for every field.

Omni-Flash-Ext

curl --request POST \
  --url https://api.qingbo.ai/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://api.qingbo.ai/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://api.qingbo.ai/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://api.qingbo.ai/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://api.qingbo.ai/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();

Text Generation

Image Generation

Video Generation

Audio

Tools & Embeddings

Task Management

Account & Usage

Quick start

Request parameters

Limits

Pricing

Response

​Quick start

​Request parameters

​Limits

​Pricing

​Response

​Related

Quick start

Request parameters

Limits

Pricing

Response

Related