MercadoSoporte← Volver a la app

OmniHuman

Los modelos de OmniHuman 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
OmniHuman 1.5Lip Syncomnihuman-1-5
OmniHuman 1.5Lip Syncomnihuman-1-5/human-identification
OmniHuman 1.5Lip Syncomnihuman-1-5/subject-detection

OmniHuman 1.5 · Lip Sync

POSTLip Syncomnihuman-1-5
campos input
image_urlstringobligatorio

Portrait image URL; any aspect ratio (people, pets, anime, etc.)

mask_urlarray<string>opcional

Optional mask image URLs (max 5) for subject detection

audio_urlstringobligatorio

Audio URL; duration must be less than 60 seconds

promptstringopcional

Optional text prompt (max 1000 chars); multi-language

output_resolutionenum<string>opcional

Output video resolution in pixels

pe_fast_modebooleanopcional

Sacrifices some quality to speed up generation

seedintegeropcional

Random seed; same positive integer gives consistent results

Ejemplo
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "omnihuman-1-5",
  "input": {
    "image_url": "https://example.com/input.jpg",
    "mask_url": [
      "https://example.com/file"
    ],
    "audio_url": "https://example.com/reference.mp3",
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "output_resolution": "1080",
    "pe_fast_mode": false,
    "seed": -1
  }
}'

OmniHuman 1.5 · Lip Sync

POSTLip Syncomnihuman-1-5/human-identification
campos input
image_urlstringobligatorio

Portrait image URL; JPG/PNG/JPEG, <5MB, resolution under 4096x4096

Ejemplo
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "omnihuman-1-5/human-identification",
  "input": {
    "image_url": "https://example.com/input.jpg"
  }
}'

OmniHuman 1.5 · Lip Sync

POSTLip Syncomnihuman-1-5/subject-detection
campos input
image_urlstringobligatorio

Portrait image URL; supports detection of up to 5 subjects

Ejemplo
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "omnihuman-1-5/subject-detection",
  "input": {
    "image_url": "https://example.com/input.jpg"
  }
}'