Text to Image

artany-seedream-4-5

Picverse phase-one image capability.

Commercial useAsync APIfrom 12 Credits

API reference

Submit this model to the capability endpoint, then poll the returned job until it is terminal. Only the parameters below are accepted.

POST /v1/images/generations

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": "artany-seedream-4-5",
  "count": 1,
  "prompt": "A cinematic coastal village",
  "resolution": "2k",
  "aspect_ratio": "16:9"
}

Parameters

FieldTypeRequiredDescriptionDefaultConstraints
modelstringYesStable Artany public model ID. Do not send provider model IDs.artany-seedream-4-5This exact public model ID.
countintegerNoNumber of images to generate in one request. The model-specific maximum is enforced.1Range: 1–4
promptstringYesNatural-language instruction describing the desired image or video. Include subject, setting, composition, motion, lighting, and style as needed.Length: 1–12000
resolutionstringNoRequested output quality tier. Available values are model-specific and can affect price."2k"Allowed: 2k, 4k
aspect_ratiostringNoOutput canvas ratio. It controls the composition frame, not the pixel resolution tier."1:1"Allowed: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 9:21, auto

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": "artany-seedream-4-5",
  "status": "queued",
  "progress": 0,
  "output": null,
  "error": null,
  "billing": {
    "estimated_credits": "12",
    "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 param when 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.

ModelcountresolutionPrice
artany-seedream-4-512k12Credits · ~$0.1200
artany-seedream-4-514k12Credits · ~$0.1200
artany-seedream-4-522k24Credits · ~$0.2400
artany-seedream-4-524k24Credits · ~$0.2400
artany-seedream-4-532k36Credits · ~$0.3600
artany-seedream-4-534k36Credits · ~$0.3600
artany-seedream-4-542k48Credits · ~$0.4800
artany-seedream-4-544k48Credits · ~$0.4800

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":"artany-seedream-4-5","count":1,"prompt":"A cinematic coastal village","resolution":"2k","aspect_ratio":"16:9"}'

# poll until terminal
curl "https://api.artany.ai/v1/jobs/{job_id}" \
  -H "Authorization: Bearer $ARTANY_API_KEY"