TU IDEA. TU INTEGRACIÓN.

Una API.
Todo tu saldo.

Después de confirmar tu pago, abre Saldo y movimientos en tu estudio y pulsa «Mostrar clave». Guárdala en tu servidor: la clave completa se muestra una sola vez. Cada compra tiene su propia clave y saldo. El estudio y tu API comparten las mismas unidades.

Consulta tu saldo

GET https://prismscene.work/v1/balance
Authorization: Bearer TU_CLAVE

Crea un video

POST https://prismscene.work/v1/video/generations
Authorization: Bearer TU_CLAVE
Idempotency-Key: un-identificador-unico
Content-Type: application/json

{
  "prompt": "Una toma cinematográfica de un bosque al amanecer",
  "aspect_ratio": "16:9",
  "content_consent": true
}

Veo 3.1 Lite · 8 segundos · 720p. Formatos 16:9 y 9:16. Cada solicitud crea un resultado y reserva una unidad. Respuesta 202 con id y status.

Crea una imagen

Mismo cuerpo y cabeceras en POST /v1/images/generations. Formatos 1:1, 16:9, 9:16, 4:3 y 3:4.

Recibe el resultado

GET /v1/tasks/ID_DEL_TRABAJO
GET /v1/tasks/ID_DEL_TRABAJO/content

Usa la misma cabecera Authorization para consultar y descargar. Estados: queued, processing, succeeded, failed, cancelled o reconcile. Espera al menos cinco segundos entre consultas. La descarga está disponible cuando status es succeeded.

Límites y reintentos

Sin saldo, no se aceptan nuevas generaciones. Video e imagen tienen saldos separados. Si la respuesta de envío se pierde, reintenta con el mismo Idempotency-Key y el mismo cuerpo para evitar duplicados. Nunca cambies la clave para reintentar un envío incierto. Un fallo técnico confirmado libera la unidad reservada; una solicitud incierta conserva la reserva hasta verificarla.

401: clave inválida, revocada o cuenta no activa. 403: petición no permitida. 404: trabajo no disponible para esa clave. 409: saldo insuficiente, capacidad ocupada, servicio pausado o datos incompatibles con el identificador. 429: límite de solicitudes. No incluyas tu clave en páginas públicas, aplicaciones cliente, repositorios ni URLs.