MercadoSoporte← Volver a la app

Gemini Omni

Los modelos de Gemini Omni se llaman a través de una API de trabajos asíncrona y unificada. Inicia una tarea con POST /api/generate y luego sondea GET /api/generate/{taskId} hasta que termine. Esta familia expone 3 endpoints.

Resumen

Todos los endpoints comparten la misma envoltura — solo cambian model y los campos input. Ejecuta cualquiera desde el playground del Mercado de modelos.

Autenticación

Crea una API key en /api-keys y luego envíala como token Bearer. Las solicitudes desde el navegador con sesión iniciada también funcionan mediante la cookie de sesión.

Authorization: Bearer <YOUR_API_KEY>

Crear tarea

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

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

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

Consultar resultado

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

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

Asíncrono
Un 200 de Crear tarea solo significa que la tarea fue aceptada — no que haya terminado. Sondea este endpoint hasta que state sea success o fail. Las tareas fallidas no se facturan.

Endpoints

ModeloTareamodel 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
campos input
promptstringobligatorio

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

image_urlsarray<string>opcional

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

audio_idsarray<string>opcional

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

video_listarray<object>opcional

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

character_idsarray<string>opcional

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

durationenum<string>opcional

Generated video duration in seconds

aspect_ratioenum<string>opcional

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

seedintegeropcional

Random seed [0, 2147483647] for reproducibility

resolutionenum<string>opcional

Output video resolution

Ejemplo
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
campos input
audio_idenum<string>obligatorio

Voice character preset selection

namestringobligatorio

Voice identifier (max 210 characters)

voice_descriptionstringopcional

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

example_dialoguestringopcional

Sample speech utterance for voice preview (max 120 chars)

Ejemplo
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
campos input
descriptionsstringobligatorio

Character appearance, identity, style, clothing, or personality

image_urlsarray<string>obligatorio

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

audio_idsarray<string>opcional

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

character_namestringopcional

Character name

Ejemplo
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"
  }
}'