Use Imagild image and video models from your own applications.
Keep API keys in server-side environment variables. Never commit a full key or expose it in a browser.
Checking access…
| Name | API Key | Status | Actions |
|---|---|---|---|
| No records | |||
https://imagild.com/api/relay/v1Authorization: Bearer YOUR_API_KEYAPI calls require an active membership. Credits are reserved at submission and released on confirmed failure. Image rates match the image marketplace: 1K 10, 2K 15 and 4K 20 credits per image. Video rates follow the workbench. Submitted tasks keep their original quote.
Integration guideRun these cURL examples in Bash or zsh. Replace YOUR_API_KEY with the key you just saved.
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"}}}Model hubReplace TASK_ID with data.id from the response. Poll every 5 seconds; download only after data.status is succeeded. Change the output filename to result.png for images.
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.