Text to Image

artany-nano-banana-2

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-2","count":1,"prompt":"A cinematic coastal village","resolution":"0.5k","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-2",
  "count": 1,
  "prompt": "A cinematic coastal village",
  "resolution": "0.5k",
  "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-2	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.	"0.5k"	Allowed: 0.5k, 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: auto, 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1

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-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.

count	resolution	web_search	Credits
1	0.5k	any	15
1	0.5k	true	20
1	1k	any	23
1	1k	true	28
2	0.5k	any	30
1	2k	any	34
1	2k	true	39
2	0.5k	true	40
3	0.5k	any	45
2	1k	any	46
1	4k	any	51
1	4k	true	56
2	1k	true	56
4	0.5k	any	60
3	0.5k	true	60
2	2k	any	68
3	1k	any	69
2	2k	true	78
4	0.5k	true	80
3	1k	true	84
4	1k	any	92
2	4k	any	102
3	2k	any	102
2	4k	true	112
4	1k	true	112
3	2k	true	117
4	2k	any	136
3	4k	any	153
4	2k	true	156
3	4k	true	168
4	4k	any	204
4	4k	true	224