MarketSupport← Back to app

Gemini Omni

Gemini Omni models are called through one unified, asynchronous job API. Start a task with POST /api/generate, then poll GET /api/generate/{taskId} until it finishes. This family exposes 3 endpoints.

Overview

Every endpoint shares the same envelope — only model and the input fields change. Run any from the Models Market playground.

Authentication

Create an API key at /api-keys, then send it as a Bearer token. Requests from the browser while logged in also work via the session cookie.

Authorization: Bearer <YOUR_API_KEY>

Create Task

POST
POST https://api.lithovas.com/api/generate

Body: { "model": "<slug>", "input": { … } }

Response: { "taskId": "<id>", "state": "waiting" }

Query Result

GET
GET https://api.lithovas.com/api/generate/<taskId>

Response: { "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

Asynchronous
A 200 from Create Task only means the task was accepted — not finished. Poll this endpoint until state becomes success or fail. Failed tasks are not billed.

Endpoints

ModelTaskmodel slug
Gemini Omni VideoText to Videogemini-omni-video
Gemini Omni AudioText to Speechgemini-omni-audio
Gemini Omni CharacterChatgemini-omni-character

Gemini Omni Video · Text to Video

POSTText to Videogemini-omni-video
input fields
promptstringrequired

Video prompt describing content, style, camera language, or actions

image_urlsarray<string>optional

Array of reference image URLs (max 7, each <=20MB)

audio_idsarray<string>optional

Audio IDs from gemini-omni-audio for narration/dialogue (max 3)

video_listarray<object>optional

Source video clips with trim ranges (max 1, <=100MB, <=30s)

character_idsarray<string>optional

Character IDs from gemini-omni-character API (max 3)

durationenum<string>optional

Generated video duration in seconds

aspect_ratioenum<string>optional

Video aspect ratio (16:9 landscape, 9:16 portrait)

seedintegeroptional

Random seed [0, 2147483647] for reproducibility

resolutionenum<string>optional

Output video resolution

Example
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-omni-video",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "audio_ids": [
      "https://example.com/reference.mp3"
    ],
    "video_list": [],
    "character_ids": [
      "https://example.com/file"
    ],
    "duration": "4",
    "aspect_ratio": "16:9",
    "seed": 42,
    "resolution": "720p"
  }
}'

Gemini Omni Audio · Text to Speech

POSTText to Speechgemini-omni-audio
input fields
audio_idenum<string>required

Voice character preset selection

namestringrequired

Voice identifier (max 210 characters)

voice_descriptionstringoptional

Timbre, style, rate, emotion characteristics (max 20000 chars)

example_dialoguestringoptional

Sample speech utterance for voice preview (max 120 chars)

Example
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-omni-audio",
  "input": {
    "audio_id": "achernar",
    "name": "example",
    "voice_description": "example",
    "example_dialogue": "example"
  }
}'

Gemini Omni Character · Chat

POSTChatgemini-omni-character
input fields
descriptionsstringrequired

Character appearance, identity, style, clothing, or personality

image_urlsarray<string>required

Array of character reference image URLs (max 1, <=20MB each)

audio_idsarray<string>optional

Audio IDs from gemini-omni-audio for voice traits/persona

character_namestringoptional

Character name

Example
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-omni-character",
  "input": {
    "descriptions": "example",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "audio_ids": [
      "https://example.com/reference.mp3"
    ],
    "character_name": "example"
  }
}'