API de imagen para activos estáticos
Elige imagen si el resultado es un fotograma y mandan resolución, referencias o calidad.
Usa Imya como capa de API para generar imágenes y vídeo, consultar tareas, calcular créditos en tiempo real y entregar archivos. Aquí se documentan los contratos en vista previa de GPT Image 2, Seedream 5.0 Pro, Hailuo 2.3 y Seedance 2.0.
Cada página explica el endpoint disponible, los parámetros públicos, la respuesta de facturación y el ciclo de vida de la tarea.
Generación desde texto o imágenes de referencia, créditos por resolución y consulta de tareas.
Generación desde texto y hasta diez imágenes de referencia, con control de relación, calidad y formato.
Texto a vídeo e imagen a vídeo, incluida la variante Fast de menor latencia.
Texto o imagen a vídeo con controles de duración, resolución, relación de aspecto y audio.
Crea una API Key en la configuración.
Envía una solicitud con model y prompt.
Consulta el endpoint de la tarea hasta que termine o falle.
Guarda en tu aplicación la URL de imagen o vídeo devuelta.
Guía de integración de API de modelos de IA
Decide primero si tu producto devuelve una imagen o un vídeo y después los controles necesarios. Los cuatro modelos de Imya comparten autenticación y tareas asíncronas, por lo que puedes reutilizar infraestructura.
Elige imagen si el resultado es un fotograma y mandan resolución, referencias o calidad.
Elige vídeo para movimiento; valida texto o imagen inicial, duración y resolución, y prepara una cola separada.
La referencia de cada modelo define los campos; usa credits_reserved de la respuesta como coste exacto.
Para prompts o hasta 16 referencias y salidas 1K, 2K y 4K.
Leer GPT Image 2 APIPara hasta 10 referencias y calidad basic o high.
Leer Seedream 5.0 Pro APIPara texto o imagen a vídeo de 6 o 10 segundos, Standard o Fast.
Leer Hailuo 2.3 APIPara texto o imagen a vídeo en 480p, 720p o 1080p y de 4 a 15 segundos.
Leer Seedance 2.0 APIGuarda la API Key fuera del navegador y centraliza creación, consulta, facturación y estado en tu backend.
Envía Bearer token e Idempotency-Key única. Repetir la misma clave y cuerpo devuelve la tarea original.
credits_reserved se descuenta al aceptar. Registra el valor y no dupliques precios en el cliente.
Guarda id y consulta GET /v1/tasks/{id} cada 5 segundos o más hasta pending, processing, succeeded o failed.
Tras 30 minutos una tarea sin terminar falla. refund_pending indica liquidación y credits_refunded confirma el reembolso único.
Completa estos controles antes del tráfico real.
Respuestas comunes a los cuatro modelos.
Empieza por el modelo que produce el primer flujo y añade otro cuando su ciclo sea fiable.
Sí, con la misma Idempotency-Key y cuerpo; se devuelve la tarea original sin otro cargo.
Se descuenta credits_reserved al aceptar y los fallos elegibles se reembolsan una vez con la caducidad original.
7 días en cuentas gratis y hasta 30 en cuentas activas de pago o Lifetime.
Abre la referencia más cercana a tu caso y completa crear, consultar y obtener resultado antes de añadir otro modelo.