Seedream 5.0 Pro API

High-detail images up to 4K.

Standard20 Credits / image ($0.10)25% less than fal fal price $0.135 per image

Full pricing ↓

Prompt

Image 1https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/ending.jpg

Size

Pick a preset, or Custom for WIDTHxHEIGHT with 3.7 to 10.4 MP in total.

Fixed for this input: Output format: jpeg

Advanced

Watermark

Seed

The same seed and settings give a similar result. Leave it empty for a random seed.

Optimize prompt

Rewrites your prompt before generating.

Checking whether you’re signed in.

Pricing

Prices as of 2026-11-09

Tier	Price
Standard	20 Credits / image ($0.10)^{Note 11}

Extra input images: 1 Credits each after 1 included.

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.

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-pro",
  "input": {
    "prompt": "A cinematic wide film still. A lone astronaut in a white suit stands on a pale grey lunar plain, head tilted up, looking at a vast dark graphite ring-shaped space station hanging low in the black sky, seen from slightly below. The ring is not closed: a clear gap cuts through one side. A small amber planet glows in the middle of the ring. The station'\''s armored panels and line of tiny lights match the reference image. Hard low sunlight, long shadows, fine film grain. No text, no letters."
  },
  "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.

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 10. At most 10 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. Seedream 5.0 Pro returns JPEG only. Allowed values`jpeg` Default `jpeg`
`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 20 Credits per image. One image holds 20.000 Credits.

Request

{
  "model": "seedream-5-0-pro",
  "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-pro",
  "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": "20.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-pro",
  "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": "20.000",
    "reserved": "0.000",
    "charged": "20.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 Pro

Pricing

Delivery and billing

API reference

Similar models