Text to Image

artany-nano-banana-pro

Picverse phase-one image capability.

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":"artany-nano-banana-pro","count":1,"prompt":"A cinematic coastal village","resolution":"1k","aspect_ratio":"16:9"}'

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": "artany-nano-banana-pro",
  "count": 1,
  "prompt": "A cinematic coastal village",
  "resolution": "1k",
  "aspect_ratio": "16:9"
}

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. Do not send provider model IDs.	artany-nano-banana-pro	This exact public model ID.
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
resolution	string	No	Requested output quality tier. Available values are model-specific and can affect price.	"1k"	Allowed: 1k, 2k, 4k
web_search	boolean	No	Whether to allow the model's supported web-search enhancement when generating the result.	false	—
aspect_ratio	string	No	Output canvas ratio. It controls the composition frame, not the pixel resolution tier.	"1:1"	Allowed: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 4:5, 5:4, 21:9

Response and task status

A successful submission returns HTTP 202. The response shape is the same for every Artany model; provider-specific task formats are not exposed.

{
  "id": "job_…",
  "object": "generation.job",
  "model": "artany-nano-banana-pro",
  "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.

count	resolution	web_search	Credits
1	0.5k	any	30
1	0.5k	true	35
1	1k	any	45
1	2k	any	45
1	1k	true	50
1	2k	true	50
2	0.5k	any	60
2	0.5k	true	70
1	4k	any	80
1	4k	true	85
2	1k	any	90
2	2k	any	90
3	0.5k	any	90
2	1k	true	100
2	2k	true	100
3	0.5k	true	105
4	0.5k	any	120
3	1k	any	135
3	2k	any	135
4	0.5k	true	140
3	1k	true	150
3	2k	true	150
2	4k	any	160
2	4k	true	170
4	1k	any	180
4	2k	any	180
4	1k	true	200
4	2k	true	200
3	4k	any	240
3	4k	true	255
4	4k	any	320
4	4k	true	340