REFERENCIA

API de Eviolite

Genera vídeo e imagen desde tu código. Un crédito es un crédito en todas partes, y si una generación falla se te devuelve automáticamente.

¿No programas? Conecta Eviolite a Claude en un clic →

1. Autenticación

Crea una clave en Mi cuenta — se enseña una sola vez. Va en la cabecera de cada petición:

Authorization: Bearer evio_live_tu_clave

Dirección base: https://eviolite.app/api/v1

2. Generar

POST /api/v1/generate

curl -X POST https://eviolite.app/api/v1/generate \
  -H "Authorization: Bearer evio_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "text",
    "prompt": "a cat astronaut floating inside a spaceship",
    "model": "sg_veo",
    "aspect": "portrait",
    "duration": 8,
    "resolution": "1080p"
  }'
modeobligatoriotext · image · frames · ingredients
promptobligatorioQué generar. De 3 a 5000 caracteres.
modelstringId del modelo (ver abajo). Por defecto sg_veo en vídeo, sg_nano_banana_2 en imagen.
aspectstringportrait (9:16, por defecto) · landscape (16:9)
durationenteroSegundos de vídeo. Sólo los que admita el modelo.
resolutionstringVídeo: 480p/720p/1080p · Imagen: 1K/2K/4K.
refsarrayURLs públicas de imágenes de referencia.
startImagestringPrimer fotograma, con mode=frames.

Devuelve { "id": "..." } al instante. El crédito se descuenta al lanzar.

3. Animar una imagen

Con mode: "frames" la imagen es el primer fotograma y el prompt describe qué ocurre después. Cuesta lo mismo que un vídeo de texto.

curl -X POST https://eviolite.app/api/v1/generate \
  -H "Authorization: Bearer evio_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "frames",
    "prompt": "the camera slowly pushes in, hair moving in the wind",
    "model": "sg_veo",
    "startImage": "https://…/foto.jpg",
    "duration": 8
  }'

startImage tiene que ser una URL pública: el servidor descarga la imagen para generar. Si la tienes en disco, súbela primero y usa la URL que devuelve.

POST /api/v1/upload

curl -X POST https://eviolite.app/api/v1/upload \
  -H "Authorization: Bearer evio_live_tu_clave" \
  -H "Content-Type: image/jpeg" \
  --data-binary @foto.jpg

Devuelve { "url": "https://…" }. PNG, JPG o WEBP, hasta 4 MB, y no gasta créditos. Desde el navegador hay un formulario en /subir (hasta 10 MB).

4. Recoger el resultado

GET /api/v1/generations/{id}

curl https://eviolite.app/api/v1/generations/ID -H "Authorization: Bearer evio_live_tu_clave"

Consulta cada 5 segundos. Un vídeo tarda 75-95 s; una imagen, 30-45 s.

processingestadoSigue generando.
completedestadoListo. files[] trae las rutas de descarga.
failed / refundedestadoFalló; el crédito ya se ha devuelto.

5. Saldo

GET /api/v1/credits

curl https://eviolite.app/api/v1/credits -H "Authorization: Bearer evio_live_tu_clave"

Modelos y coste

VÍDEO

  • Veo 3.1 Fastsg_veo4 cr
  • Veo 3.1 Litesg_veo_lite4 cr
  • Omni Flashsg_omni_flash13 cr
  • Grok Videosg_grok_video15 cr
  • Veo 2 (sin audio)sg_veo_220 cr
  • Kling 2.6sg_kling_2630 cr
  • Kling 2.5sg_kling_2530 cr
  • Kling 2.1 (5 s)sg_kling_21_535 cr
  • Kling O1sg_kling_o150 cr
  • Seedance 2 Minisg_seedance_mini50 cr
  • Kling 2.1 (10 s)sg_kling_21_1060 cr
  • Seedance 2sg_seedance60 cr
  • Seedance 2 Omnisg_seedance_omni95 cr
  • Veo 3.1 Máxima calidadsg_veo_max100 cr
  • Kling 3.0sg_kling_3150 cr

IMAGEN

  • Meta AIsg_meta_ai1 cr
  • Nano Banana 2sg_nano_banana_23 cr
  • Nano Banana 2 Litesg_nano_banana_lite3 cr
  • Nano Banana Prosg_nano_banana_pro3 cr
  • Grok Imagesg_grok_image4 cr
  • GPT Image 2sg_gpt_image_27 cr

Errores y límites

401unauthorizedFalta la clave o está revocada.
402no_creditsSin créditos suficientes.
400invalid_modelModelo inexistente o parámetro no admitido.
429rate_limitDemasiadas peticiones o demasiadas a la vez. Reintenta según Retry-After.
503maintenanceServicio en mantenimiento; no se descuenta nada.

El número de generaciones simultáneas y el ritmo por minuto dependen de tu plan. Las que no caben no se rechazan: entran en cola y salen por orden de prioridad.

Referencia completa en formato OpenAPI: /api/v1/openapi →