Seedream 5.0 Lite API

Low-cost images from text or reference images.

Reference images plus output images total at most 15 per request
Up to 14 reference images at no extra charge

Standard7 Credits / image ($0.035)

Full pricing ↓

Your result appears here

Pricing

Prices as of 2026-11-09

Tier	Price
Standard	7 Credits / image ($0.035)

1 Credit ≈ $0.005. At the standard pack price. Larger packs include bonus Credits, so each Credit costs less.

Delivery and billing

Output: Finished files are listed in the task result with an asset ID and type for each.
Download: Files are kept for 7 days and downloaded through short-lived signed links. You can delete them any time.
Billing: Credits are held when a task is accepted and charged on delivery. If generation fails, or nothing is delivered within 24 hours, the held Credits are released in full.
Notifications: Poll the task by ID, or use signed webhooks and deduplicate by event_id.

How is it billed?

By output image.

Do failed generations cost anything?

No. If generation fails, or nothing is delivered within 24 hours of acceptance, the held Credits are released in full.

API reference

Create the task once, then poll it by its ID. Full script with upload and download · API reference

Request

API=https://api.vizoapi.com/v1
AUTH="Authorization: Bearer $VIZO_API_KEY"

# Create the task once and keep its ID.
ID=$(curl -fsS $API/generations -H "$AUTH" -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-lite",
  "input": {
    "prompt": "A bowl of ramen, backlit by steam"
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}' | jq -r .id)

# Poll until the task closes, then read its status and result.
until curl -fsS $API/generations/$ID -H "$AUTH" | jq -e '.closed_at != null' > /dev/null; do sleep 5; done
curl -fsS $API/generations/$ID -H "$AUTH" | jq '{status, result}'

All fields

Send these fields in input. A field the table does not list is refused with HTTP 422 invalid_input.

optimize_prompt_options is allowed only with optimize_prompt set to true.
sequential_image_generation_options is required when sequential_image_generation is auto and allowed only then; reference images plus max_images are at most 15.

Request parameters
Field	Description
`prompt`stringRequired	Text prompt. Must not be blank.
`seed`integerOptional	Random seed; -1 picks one at random. Minimum -1 · Maximum 9223372036854775807
`size`stringOptional	Output size: WIDTHxHEIGHT with 3,686,400 to 10,404,496 pixels in total, or 2k or 3k. Pattern`^([1-9][0-9]x[1-9][0-9]\|2k\|3k)$`
`image`array of stringsOptional	Reference images, up to 14. At most 14 items
`optimize_prompt`booleanOptional	Rewrites the prompt before generation. Default `false`
`optimize_prompt_options`objectOptional	Allowed only with optimize_prompt set to true.
`optimize_prompt_options.thinking`stringOptional	Prompt expansion. Allowed values`autoenableddisabled`
`optimize_prompt_options.mode`stringOptional	Optimization mode. Only standard. Only `standard`
`output_format`stringOptional	Image file format. Allowed values`jpegpng` Default `jpeg`
`sequential_image_generation`stringOptional	auto generates a set of related images and requires sequential_image_generation_options.max_images; disabled generates one image. Allowed values`autodisabled` Default `disabled`
`sequential_image_generation_options`objectOptional	Allowed only with sequential_image_generation set to auto. Reference images plus max_images must not exceed 15.
`sequential_image_generation_options.max_images`integerRequired	Number of images to generate, 1 to 15. The hold covers each requested image; a succeeded task is charged only for the images delivered. Minimum 1 · Maximum 15
`watermark`booleanOptional	Add a visible watermark. Defaults to false; the tier price is unchanged. Default `false`

Full example request and response

A complete create request, the 202 answer and the task once it has succeeded. This input selects the standard tier at 7 Credits per image. One image holds 7.000 Credits.

Request

{
  "model": "seedream-5-0-lite",
  "input": {
    "prompt": "A paper boat on a pond at dawn, soft watercolor"
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}

202 Accepted

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "seedream-5-0-lite",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "processing",
  "execution_status": "processing",
  "delivery_status": "pending",
  "billing_status": "pending",
  "version": 1,
  "price": {
    "unit": "credit",
    "estimated": "7.000",
    "reserved": "0.000",
    "charged": "0.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": null,
  "error": null,
  "result": null
}

200 Succeeded

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "seedream-5-0-lite",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "succeeded",
  "execution_status": "succeeded",
  "delivery_status": "ready",
  "billing_status": "settled",
  "version": 4,
  "price": {
    "unit": "credit",
    "estimated": "7.000",
    "reserved": "0.000",
    "charged": "7.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": "2026-11-08T09:01:31Z",
  "error": null,
  "result": {
    "asset_id": "ast_01JD8Z9M2C4V",
    "outputs": [
      {
        "index": 0,
        "asset_id": "ast_01JD8Z9M2C4V",
        "content_type": "image/jpeg"
      }
    ]
  }
}

Full API reference for Seedream 5.0 Lite

Pricing

Delivery and billing

API reference

Similar models