Image to Image

artany-gpt-image-2-edit

Picverse phase-one image capability.

POST /v1/images/editsAsync 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/edits" \
  -H "Authorization: Bearer $ARTANY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id" \
  -d '{"model":"artany-gpt-image-2-edit","count":1,"prompt":"A cinematic coastal village","resolution":"1k","aspect_ratio":"16:9","input_images":["https://example.com/input.png"]}'

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-gpt-image-2-edit",
  "count": 1,
  "prompt": "A cinematic coastal village",
  "resolution": "1k",
  "aspect_ratio": "16:9",
  "input_images": [
    "https://example.com/input.png"
  ]
}

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-gpt-image-2-edit	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
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, 3:2, 2:3, 5:4, 4:5, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21
input_images	array (string items)	Yes	Source image URLs used for editing. Their order is preserved when the selected model supports multiple inputs.	—	Items: 1–16

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-gpt-image-2-edit",
  "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	Credits
1	6
2	12
3	18
4	24