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","web_search":false,"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",
  "web_search": false,
  "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.	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: 1:1, 1:4, 4:1, 1:8, 8:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto

Response and task status

A successful asynchronous submission returns HTTP 202 with a supplier-neutral job.

{
  "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
2	1k	true	56
1	4k	true	56
3	0.5k	true	60
4	0.5k	any	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
3	2k	any	102
2	4k	any	102
4	1k	true	112
2	4k	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