Integra los modelos de imagen y vídeo de Imagild en tus aplicaciones.
Guarda las claves en variables del servidor. No publiques claves completas en código ni en el navegador.
Comprobando acceso…
| Nombre | API Key | Estado | Acciones |
|---|---|---|---|
| Sin registros | |||
https://imagild.com/api/relay/v1Authorization: Bearer YOUR_API_KEYLa API requiere membresía activa. Se reservan puntos al enviar y se liberan si se confirma un fallo. Las imágenes usan las mismas tarifas del mercado: 1K 10, 2K 15 y 4K 20 puntos por imagen. El vídeo conserva las tarifas del estudio; las tareas enviadas mantienen su presupuesto original.
Primeros pasosEjemplos cURL para Bash / zsh. Sustituye YOUR_API_KEY por la clave guardada.
export IMAGILD_API_KEY='YOUR_API_KEY'curl 'https://imagild.com/api/relay/v1/images/generations' \
-H "Authorization: Bearer $IMAGILD_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: image-demo-0001' \
-d '{"model":"gpt-image-2.5","prompt":"A blue paper boat on calm water","resolution":"1K"}'{"data":{"id":"TASK_ID","status":"queued","usage":{"state":"reserved"}}}Catálogo de modelosSustituye TASK_ID por data.id. Consulta cada 5 segundos y descarga cuando data.status sea succeeded. Usa result.png como nombre del archivo de imagen.
curl 'https://imagild.com/api/relay/v1/tasks/TASK_ID' \
-H "Authorization: Bearer $IMAGILD_API_KEY"curl 'https://imagild.com/api/relay/v1/tasks/TASK_ID/content' \
-H "Authorization: Bearer $IMAGILD_API_KEY" \
-o result.pngUpload an image with multipart field photo (up to 20 MB). Use the returned file_id in image or video generation. A completed image task can instead be referenced using image_task_id; never provide both.
curl 'https://imagild.com/api/relay/v1/files' \
-H "Authorization: Bearer $IMAGILD_API_KEY" \
-F 'photo=@reference.jpg'Generation is asynchronous: POST returns a task ID, then query it every 5 seconds. Download output_url with the same Bearer key once status is succeeded.
Set a new Idempotency-Key for each new generation. Retry the same generation with the same key and identical parameters; this reuses the task. Changed parameters return 409. Never create a new key to retry an unknown upstream result.
Up to 5 active keys. Per account: 10 generation/upload requests and 120 read requests per minute. Exceeded limits return 429. Keys stop working immediately when revoked, expired, or membership ends.
If status is unknown, do not resubmit: contact support to reconcile the original task. Failed jobs release reserved points under the website billing rules.
These are asynchronous HTTP APIs; the synchronous OpenAI SDK image response format is not supported.