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": "wan2.7-image",
"prompt": "A cinematic coastal village at sunrise",
"count": 1,
"size": "1:1",
"resolution": "1K",
"thinking_mode": true,
"enable_sequential": false
}Parameters
| Field | Type | Required | Description | Default | Constraints |
|---|---|---|---|---|---|
| model | string | Yes | Stable Artany public model ID. | wan2.7-image | 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, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 |
| count | integer | No | Number of images to generate in one request. The model-specific maximum is enforced. | 1 | Range: 1–12 |
| 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 |
| image_urls | array | No | Public image URLs or supported image data used as source or reference images. | — | Items: 1–9 |
| resolution | string | No | Requested output quality tier. Available values are model-specific and can affect price. | "1K" | Allowed: 1K, 2K, 4K |
| thinking_mode | boolean | No | Whether to use the model's supported reasoning or planning mode before image generation. | true | Allowed: false, true |
| negative_prompt | string | No | Elements, styles, or visual characteristics to avoid in the generated result. | — | Length: 1–12000 |
| enable_sequential | boolean | No | Whether to enable the model's supported sequential image-generation behavior. | false | Allowed: false, true |
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": "wan2.7-image",
"status": "queued",
"progress": 0,
"output": null,
"error": null,
"billing": {
"estimated_credits": "5",
"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 | count | Price |
|---|---|---|
| wan2.7-image | 1 | 5Credits · ~$0.0500 |
| wan2.7-image | 2 | 10Credits · ~$0.1000 |
| wan2.7-image | 3 | 15Credits · ~$0.1500 |
| wan2.7-image | 4 | 20Credits · ~$0.2000 |
| wan2.7-image | 5 | 25Credits · ~$0.2500 |
| wan2.7-image | 6 | 30Credits · ~$0.3000 |
| wan2.7-image | 7 | 35Credits · ~$0.3500 |
| wan2.7-image | 8 | 40Credits · ~$0.4000 |
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":"wan2.7-image","prompt":"A cinematic coastal village at sunrise","count":1,"size":"1:1","resolution":"1K","thinking_mode":true,"enable_sequential":false}'
# poll until terminal
curl "https://api.artany.ai/v1/jobs/{job_id}" \
-H "Authorization: Bearer $ARTANY_API_KEY"