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"
}'| mode | obligatorio | text · image · frames · ingredients |
| prompt | obligatorio | Qué generar. De 3 a 5000 caracteres. |
| model | string | Id del modelo (ver abajo). Por defecto sg_veo en vídeo, sg_nano_banana_2 en imagen. |
| aspect | string | portrait (9:16, por defecto) · landscape (16:9) |
| duration | entero | Segundos de vídeo. Sólo los que admita el modelo. |
| resolution | string | Vídeo: 480p/720p/1080p · Imagen: 1K/2K/4K. |
| refs | array | URLs públicas de imágenes de referencia. |
| startImage | string | Primer 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.
| processing | estado | Sigue generando. |
| completed | estado | Listo. files[] trae las rutas de descarga. |
| failed / refunded | estado | Falló; 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
| 401 | unauthorized | Falta la clave o está revocada. |
| 402 | no_credits | Sin créditos suficientes. |
| 400 | invalid_model | Modelo inexistente o parámetro no admitido. |
| 429 | rate_limit | Demasiadas peticiones o demasiadas a la vez. Reintenta según Retry-After. |
| 503 | maintenance | Servicio 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 →