Text to Image

doubao-seedream-5-0-pro

Draft model pending operator verification

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":"doubao-seedream-5-0-pro","prompt":"A small blue paper kite","size":"1:1","resolution":"2K","output_format":"jpeg"}'

Request

Headers

HeaderRequiredDescription
AuthorizationYesBearer token for an Artany API key.
Content-TypeYesMust be application/json.
Idempotency-KeyRecommended8–128 characters. Reusing it with an identical request prevents duplicate jobs and charges.

Body

{
  "model": "doubao-seedream-5-0-pro",
  "prompt": "A small blue paper kite",
  "size": "1:1",
  "resolution": "2K",
  "output_format": "jpeg"
}

Request Parameters

Only fields in this model’s public request contract are shown. Defaults are applied before validation and quoting.

Note:This quality-first model generates one image per request.

modelstringrequireddefault: "doubao-seedream-5-0-pro"

Stable public model ID for this request.

promptstringrequired

Text description for image generation.

Length: 1–1000

Note:For best detail retention, keep the prompt within 600 English words.

sizestringdefault: "1:1"

Output image aspect ratio. Use one of the supported ratios or let the model choose with auto.

Allowed: 1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9, auto

1:12:33:23:44:39:1616:921:9auto

Note:Custom pixel dimensions are not supported. An unsupported ratio such as 9:21 is rejected.

resolutionstringdefault: "2K"

Output image resolution. 2K is the default high-definition tier.

Allowed: 1K, 2K

Field description

1K
1:1 1024×1024 · 4:3 1152×864 · 3:4 864×1152 · 16:9 1312×736 · 9:16 736×1312 · 3:2 1248×832 · 2:3 832×1248 · 21:9 1568×672
2K
1:1 2048×2048 · 4:3 2304×1728 · 3:4 1728×2304 · 16:9 2560×1440 · 9:16 1440×2560 · 3:2 2496×1664 · 2:3 1664×2496 · 21:9 3024×1296
1K2K
  • With size set to auto, the selected resolution tier is preserved while the model chooses the final aspect ratio.

Note:Only 1K and 2K are supported. Other resolution tiers are rejected.

image_urlsarray

Reference images for image-to-image generation. Public http(s) URLs and complete Base64 Data URIs are accepted.

Items: 1–10

  • Supported formats: jpeg, png, webp, bmp, tiff, gif, heic, and heif.
  • Each image must be at most 30MB, no more than 6000×6000 pixels, and have a width-to-height ratio from 1:16 to 16:1.

Note:Base64 input must include the complete Data URI prefix, such as data:image/jpeg;base64,.

output_formatstringdefault: "jpeg"

Requested output image format.

Allowed: jpeg, png

jpegpng
  • Use jpeg for the default output or png when transparent backgrounds are needed.

Response and task status

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

{
  "id": "job_…",
  "object": "generation.job",
  "model": "doubao-seedream-5-0-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.

resolutionimage_urlsCredits
1Kany8
1K1 image8
1K2 images8
1K3 images9
1K4 images9
1K5 images10
1K6 images10
1K7 images11
1K8 images11
1K9 images12
1K10 images12
2Kany15
2K1 image15
2K2 images15
2K3 images16
2K4 images16
2K5 images17
2K6 images17
2K7 images18
2K8 images18
2K9 images19
2K10 images19