MercadoSoporte← Volver a la app

Volcengine

Los modelos de Volcengine 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 1 endpoint.

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
Video To Video Lip SyncVideo to Videovolcengine/video-to-video-lip-sync

Video To Video Lip Sync · Video to Video

POSTVideo to Videovolcengine/video-to-video-lip-sync
campos input
modeenum<string>obligatorio

Service mode: lite for frontal videos, basic for complex scenes

video_urlstringobligatorio

Video URL (360p-1080p; MOV, MP4, HDR; max 500MB)

audio_urlstringobligatorio

Target audio URL to drive lip movements; max 10MB

separate_vocalbooleanopcional

Enable vocal separation to suppress background noise

open_scenedetbooleanopcional

Enable scene segmentation and speaker ID (basic mode only)

align_audiobooleanopcional

Loop video when audio is longer than video (lite mode)

align_audio_reversebooleanopcional

Loop video backward; requires align_audio=true (lite mode)

templ_start_secondsnumberopcional

Start time of template video in seconds (lite mode)

Ejemplo
cURL
curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "volcengine/video-to-video-lip-sync",
  "input": {
    "mode": "lite",
    "video_url": "https://example.com/reference.mp4",
    "audio_url": "https://example.com/reference.mp3",
    "separate_vocal": false,
    "open_scenedet": false,
    "align_audio": true,
    "align_audio_reverse": false,
    "templ_start_seconds": 0
  }
}'