Text to Image

doubao-seedream-5-0-lite

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-lite","prompt":"A small blue paper kite","size":"1:1","resolution":"2K","count":1,"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-lite",
  "prompt": "A small blue paper kite",
  "size": "1:1",
  "resolution": "2K",
  "count": 1,
  "output_format": "jpeg"
}

Request Parameters

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

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

Stable public model ID for this request.

promptstringrequired

Text description for the generated image. State the subject, composition, style, and required details clearly.

Length: 1–1000

sizestringdefault: "1:1"

Output aspect ratio. auto matches the reference-image ratio when image_urls is supplied.

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:The 9:21 ratio is not supported by this model.

resolutionstringdefault: "2K"

Output resolution tier.

Allowed: 2K, 3K, 4K

2K3K4K
  • 2K: 1:1 2048×2048 and 16:9 2848×1600. 3K: 1:1 3072×3072 and 16:9 4096×2304. 4K: 1:1 4096×4096 and 16:9 5504×3040.

Note:Only 2K, 3K, and 4K are supported; 1K is not supported.

countintegerdefault: 1

Number of images to generate.

Range: 1–15

  • A value above 1 enables sequential image generation. The reference-image count plus generated-image count must not exceed 15.

Note:Send a plain JSON number, not a quoted string.

image_urlsarray

Reference images for image-to-image generation. Public URLs or complete Base64 Data URIs are accepted.

Items: 1–15

  • Supported formats are jpeg and png. Each image must be at most 10MB, 6000×6000 pixels, and have a width-to-height ratio from 1:3 to 3: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
  • jpeg is the default; png is suitable when a transparent background is 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-lite",
  "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.

countCredits
16
212
318
424
530
636
742
848
954
1060
1166
1272
1378
1484
1590