Text to Image
krea-2
Krea 2 image generation via the configured gputw provider
POST /v1/images/generationsAsync generationFixed Credit pricing
Quick start
Submit a request with this public model ID. The API immediately returns a normalized job; poll GET /v1/jobs/{jobId} while its status is queued or running.
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":"krea-2","prompt":"A bright editorial photo of a red bicycle in Copenhagen","size":"1:1","n":1}'Request
Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer token for an Artany API key. |
| Content-Type | Yes | Must be application/json. |
| Idempotency-Key | Recommended | 8–128 characters. Reusing it with an identical request prevents duplicate jobs and charges. |
Body
{
"model": "krea-2",
"prompt": "A bright editorial photo of a red bicycle in Copenhagen",
"size": "1:1",
"n": 1
}Parameters
Only these fields are accepted. Defaults are applied before validation and quoting.
| Field | Type | Required | Description | Default | Constraints |
|---|---|---|---|---|---|
| model | string | Yes | Stable Artany public model ID. | krea-2 | This exact public model ID. |
| prompt | string | Yes | Text description of the image to generate. | — | Length: 1–3500 |
| size | string | No | Requested output image aspect ratio or canvas size. Available values are model-specific. | "1:1" | Allowed: 1:1, 16:9, 9:16, 4:3, 3:4 |
| n | integer | No | Krea 2 returns one image per request. | 1 | Allowed: 1 |
Response and task status
A successful asynchronous submission returns HTTP 202 with a supplier-neutral job.
{
"id": "job_…",
"object": "generation.job",
"model": "krea-2",
"status": "queued",
"progress": 0,
"output": null,
"error": null,
"billing": {
"estimated_credits": "…",
"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
}- queued / running: continue polling.
- succeeded: retrieve media URLs from
output; billing has settled. - failed / canceled: inspect
error; frozen Credits are released.
Pricing
The price shown for a matching configuration is the fixed amount settled on successful completion. Price version: 2026-07-18.picverse-parity.
| n | Credits |
|---|---|
| 1 | 10 |