API reference
Submit this model to the capability endpoint, then poll the returned job until it is terminal. Only the parameters below are accepted.
Required headers
Authorization: Bearer $ARTANY_API_KEY Content-Type: application/json Idempotency-Key: unique-request-id
Use a new 8–128 character Idempotency-Key for each logical generation. Retrying the same request with the same key will not double-charge.
Request body
{
"model": "gpt-image-1-5",
"prompt": "A cinematic coastal village at sunrise",
"size": "1:1",
"count": 1,
"quality": "auto",
"background": "auto",
"moderation": "auto",
"output_format": "png"
}Parameters
| Field | Type | Required | Description | Default | Constraints |
|---|---|---|---|---|---|
| model | string | Yes | Stable Artany public model ID. | gpt-image-1-5 | This exact public model ID. |
| size | string | No | Requested output image aspect ratio or canvas size. Available values are model-specific. | "1:1" | Allowed: 1:1, 2:3, 3:2 |
| count | integer | No | Number of images to generate in one request. The model-specific maximum is enforced. | 1 | Range: 1–4 |
| prompt | string | Yes | Natural-language instruction describing the desired image or video. Include subject, setting, composition, motion, lighting, and style as needed. | — | Length: 1–12000 |
| quality | string | No | Requested quality tier for a supported image model. It may affect latency and price. | "auto" | Allowed: auto, low, medium, high |
| mask_url | string | No | Public URL of a mask image that identifies the editable area in a supported image-editing request. | — | — |
| background | string | No | Background handling option for image output when transparency or a solid background is supported. | "auto" | Allowed: auto, opaque, transparent |
| image_urls | array | No | Public image URLs or supported image data used as source or reference images. | — | Items: 1–15 |
| moderation | string | No | Provider moderation setting used when the selected image workflow supports it. | "auto" | Allowed: auto, low |
| output_format | string | No | Requested file format for the generated image when the selected model supports format selection. | "png" | Allowed: png, jpeg |
| output_compression | integer | No | Compression level for a supported output format. Higher compression may reduce file size and fidelity. | — | Range: 0–100 |
Accepted response
The submit endpoint returns HTTP 202 with a normalized job. Poll GET /v1/jobs/{jobId} until the status is terminal.
{
"id": "job_…",
"object": "generation.job",
"model": "gpt-image-1-5",
"status": "queued",
"progress": 0,
"output": null,
"error": null,
"billing": {
"estimated_credits": "18",
"frozen_credits": "…",
"charged_credits": "0",
"state": "frozen",
"price_version": "2026-07-18.picverse-parity"
},
"created_at": "2026-07-21T00:00:00.000Z",
"completed_at": null
}Lifecycle and failures
- queued / running — wait and poll again.
- succeeded — read output URLs from
output; the actual charge is settled. - failed / canceled — inspect
error; frozen Credits are released. - For a schema error, the API returns an error object and identifies the invalid field in
paramwhen applicable.
Input
Runs are billed to your Credits at the listed price — same engine as the public API.
Output
Run the model to see results here
Pricing details
Fixed catalog pricing — the listed price is exactly what a run settles for. Version 2026-07-18.picverse-parity.
| Model | size | count | quality | Price |
|---|---|---|---|---|
| gpt-image-1-5 | 1:1 | 1 | low | 2Credits · ~$0.0200 |
| gpt-image-1-5 | 2:3 | 1 | low | 2Credits · ~$0.0200 |
| gpt-image-1-5 | 3:2 | 1 | low | 2Credits · ~$0.0200 |
| gpt-image-1-5 | 1:1 | 2 | low | 3Credits · ~$0.0300 |
| gpt-image-1-5 | 1:1 | 3 | low | 4Credits · ~$0.0400 |
| gpt-image-1-5 | 2:3 | 2 | low | 4Credits · ~$0.0400 |
| gpt-image-1-5 | 3:2 | 2 | low | 4Credits · ~$0.0400 |
| gpt-image-1-5 | 1:1 | 4 | low | 5Credits · ~$0.0500 |
Integrate in minutes
curl -X POST "https://api.artany.ai/v1/images/generations" \
-H "Authorization: Bearer $ARTANY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: unique-request-id" \
-d '{"model":"gpt-image-1-5","prompt":"A cinematic coastal village at sunrise","size":"1:1","count":1,"quality":"auto","background":"auto","moderation":"auto","output_format":"png"}'
# poll until terminal
curl "https://api.artany.ai/v1/jobs/{job_id}" \
-H "Authorization: Bearer $ARTANY_API_KEY"