GPT Image 2.5 Flare
GPT Image 2.5 tuned for fast, high quality everyday generation.
Capabilities
Best for
- •Concept art and mood boards
- •Product and marketing visuals
- •Batch generation at scale
Not for
- •Exact text rendering at small sizes
- •Precise brand-logo reproduction
- •Vector output
Authentication
api key header
The Pika API uses API keys to authenticate requests. Send your key in the X-API-Key header. Your API key is a secret. Don't expose it in browsers or other client-side code. Instead, call the API from your server. The signed-in playground uses a portal session and never sends your API key.
X-API-Key: YOUR_API_KEY
Endpoint
asynchronous · poll for the result
REST Setup
plain HTTPS
Image generation runs through the REST endpoint shown above. The API is plain JSON over HTTPS, so any HTTP client works. No provider-specific SDK is required.
Generate
POST /v1/media/openai/gpt-image-2.5-flare/text-to-image
Request
curl -X POST https://api.dev.pika.art/v1/media/openai/gpt-image-2.5-flare/text-to-image \-H "X-API-Key: YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"prompt": "\nElevated fashion campaign advertisement photograph, 16:9. ONE SINGLE full-bleed photograph filling the\nentire frame — not a grid, not a collage, no panels.\nA classic red British telephone kiosk stands alone in the middle of a wide grass headland on a sea cliff,\nits door open. Several metres away, near the centre of the frame, one invented woman stands with her back\nto camera, facing out to sea, holding the handset to her ear; the coiled black cord runs taut all the way\nfrom inside the kiosk, across the grass, to her hand. She wears a long butter-yellow trench coat to the\nankle, simple and unbelted at the hem, her dark hair loosely pinned. Beyond her the sea fills the middle\nof the frame and a run of green-topped cliffs recedes into haze on the right, with a white line of surf\nat their base. Nothing else is on the headland.\nComposition: rule of thirds — the kiosk on the left third, the woman on the centre-right, the horizon\nhigh, a broad sweep of empty grass filling the foreground. Deep layering from foreground grass to distant\nheadland.\nColour: a large muted field of sea-green grass and pale grey-blue water and overcast sky, against the one\ndeep saturated pillar-box red of the kiosk. The butter-yellow coat is the single secondary note, warmer\nand softer than the red and smaller in area, so the pairing still reads first.\nLighting: soft, fully diffused overcast daylight as though through an enormous softbox — no visible sun,\nno hard shadows, no specular hotspots — but dimensional rather than flat, with a gentle key from the\nupper left, a soft luminous falloff across the grass and open shadows that keep their texture.\nGrade: natural and restrained. Low-to-moderate contrast, subtle fine grain, a slightly creamy finish,\ntexture held in the shadows, colour true. Soft but vibrant, never oversaturated, never dull or greyed.\nNo sharpening, no haloed edges.","num_images": 1,"aspect_ratio": "16:9","output_format": "png","resolution": "1K","quality": "medium"}'
Response
{"id": "media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status": "queued"}
Request body
Accepted values
- aspect_ratio
- output_format
- resolution
- background
- quality
Returns
Returns a job object with status , not the final output. Store the id from the response and poll the job until it completes.
Poll status
GET /v1/media/jobs/{request_id}
Request
curl https://api.dev.pika.art/v1/media/jobs/{request_id} \-H "X-API-Key: YOUR_API_KEY"
Response
{"id": "media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status": "running"}
Poll the job by id until it reaches a terminal state: completed or failed. A completed job carries its download URL in output, and GET /v1/media/jobs/{request_id}/content returns that same URL as { "url" } for clients that only kept the id.
The job object
Errors
shared across calls
Errors use conventional HTTP status codes with a JSON body of the shape {"message": "..."}. Validation failures return 422 with a message naming the offending field. Submit rejections after the job row exists (balance, rate limit) return the failed job envelope — branch on error.code.
| Status | When | Body |
|---|---|---|
| 401 Unauthorized | The API key is missing or invalid. | {"message":"Invalid API key"} |
| 403 Forbidden | An inactive key is rejected with a {"message"} body. A submit that the org balance or postpaid cycle limit cannot cover is rejected after the job row exists and returns the failed job envelope. GET /billing/balance separates the two: a 200 means the key is active, so the rejection was the balance or the cycle limit. | {"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"insufficient_balance","message":"Insufficient org balance"}} |
| 404 Not Found | No job with that id exists in your org, or the media path names an unknown vendor/model/function. | {"message":"media job not found"} |
| 409 Conflict | The result was requested before the job completed, or an Idempotency-Key header was reused with a different body. | {"message":"media job is not ready"} |
| 422 Unprocessable Entity | The request body failed validation: an invalid enum value, a missing required field, a wrong type, or malformed JSON. The JSON message names the offending field. A schema-valid parameter combination that cannot be priced instead fails after job creation and returns the failed job envelope with error code invalid_input. | {"message":"duration: Input should be less than or equal to 15"} |
| 429 Too Many Requests | Org limit reached: requests per minute or day, or concurrent jobs. Returned as the failed job envelope; check the Retry-After header and retry with a fresh Idempotency-Key. | {"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"rate_limited","message":"rate limit exceeded: rpm"}} |
| 503 Service Unavailable | The model rail or a backend dependency is temporarily unavailable. Returned as the failed job envelope; retry with backoff and a fresh Idempotency-Key. | {"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"provider_unavailable","message":"media dispatch unavailable"}} |