Seedream 5.0 Pro API

What it does

Seedream 5.0 Pro makes one high-resolution image from a prompt, at 2K, 3K or a custom size up to 4K. Add up to 10 reference images to edit a picture, keep a product or character, or borrow a style. The prompt goes in input.prompt and the reference images in input.image; whether you send image chooses the mode:

Every task returns exactly one image. For a set of related images in one task, use Seedream 5.0 Lite.

Every example below is a complete body for POST /v1/generations. Send the same body to POST /v1/estimates first: it is free, creates no task, holds no Credits, and refuses an invalid body with the same 422 as a create. The https://media.vizoapi.com/... files are public samples, so the examples run as they are; replace them with your own files or uploaded ast_... asset IDs.

Modes

Text to image

Send only prompt. Pick the size with size: 2k, 3k, or an exact WIDTHxHEIGHT (see [Output](#output)). For 4K, send the pixel size, such as 3840x2160; the word 4k is refused.

{
  "model": "seedream-5-0-pro",
  "input": {
    "prompt": "A paper boat on a still pond at dawn, mist on the water, soft natural light, photorealistic, shallow depth of field",
    "size": "2k"
  }
}

{
  "model": "seedream-5-0-pro",
  "input": {
    "prompt": "Wide cinematic view of a black monolith on an empty savanna at sunrise, long shadows, fine film grain",
    "size": "3840x2160",
    "output_format": "jpeg",
    "seed": 42
  }
}

Reference images and editing

Put 1 to 10 images in image, in the order you want to name them. With one image, the prompt can edit it: change an object, the background, the light or the style, and say what must stay. With several, combine them: a character from one, a place from another, the style of a third. Name each by its order in the prompt ("image 1", "image 2").

An 11th image is refused (rule too_many_items). Each item is a public https URL or an ast_... asset ID; anything else is refused (rule bad_format). The first reference image is included in the price; each one after it adds a small charge (see [How it is billed](#how-it-is-billed)).

{
  "model": "seedream-5-0-pro",
  "input": {
    "prompt": "Replace the black monolith in image 1 with a tall crystal obelisk; keep the landscape, light and composition unchanged",
    "image": [
      "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/monolith.jpg"
    ],
    "size": "2k"
  }
}

{
  "model": "seedream-5-0-pro",
  "input": {
    "prompt": "Poster: the ring-shaped space station from image 2 hangs in the sky above the monolith and savanna from image 1, golden hour, clean title space at the top",
    "image": [
      "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/monolith.jpg",
      "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/station.jpg"
    ],
    "size": "2304x3072"
  }
}

Prompt optimization

Any mode can set "optimize_prompt": true to have the prompt rewritten before generation. optimize_prompt_options tunes it: thinking is auto, enabled or disabled, and mode is only standard. Sending optimize_prompt_options without "optimize_prompt": true is refused (rule optimize_options_without_optimize). The price does not change.

{
  "model": "seedream-5-0-pro",
  "input": {
    "prompt": "cozy reading corner, rainy evening",
    "optimize_prompt": true,
    "optimize_prompt_options": { "thinking": "enabled", "mode": "standard" },
    "size": "3k"
  }
}

Input limits

Plain http, private or local addresses, URLs with a user name or #fragment, and Base64 data are refused with 422 (rule bad_format). The model fetches a linked image itself, possibly some time after acceptance, so keep it reachable until the task closes; if it cannot, the task fails with generation_failed. See Model inputs and media.

Output

A succeeded task lists one JPEG image in result.outputs: take its asset_id and get a download URL with download an asset. Outputs are kept for 7 days. See Get results.

How it is billed

The model has one tier, standard, priced per output image. The listed price, 20 Credits per image, already covers every size this model accepts, from 2K to 4K, so size, output_format, seed, optimize_prompt and watermark do not change it.

Reference images: the first is included; each one after it adds the extra input image charge shown in the [Pricing](#pricing) section below.

A succeeded task is charged for the image delivered, plus the same reference image charge, so price.charged equals the hold. A failed, canceled or unresolved task is not charged and its hold is released. Send the body to POST /v1/estimates to see the exact hold and its basis (outputs, input_images, large). See Billing.

Errors and behaviors

Moderation is always on; no field turns it off. Each task has a 24-hour deadline from acceptance. A task still unfinished then closes as unresolved, releases its hold and is not charged; if its result arrives later, it is added at no charge and late_result_available becomes true. See Errors and Get results.

Prompting tips

• Describe the picture, not the process: subject, setting, composition, light, lens and style. "Close-up product shot on white marble, soft window light, 85 mm" works better than a list of keywords.
• Pick size for the framing you want. A tall 2304x3072 suits posters and phone screens, a wide 3840x2160 suits banners and desktop backgrounds.
• To edit, say exactly what changes and what stays: "replace the sky with a storm; keep the people, their pose and the framing unchanged".
• With several references, name each by its order and say what to take from it: "the jacket from image 2 on the person in image 1, in the style of image 3".
• Put text you want in the image in quotes, and say where it goes: a title "NORTH STAR" at the top, in bold white letters.
• Keep seed fixed while you adjust the wording, to see what the wording changes.

Pricing

Each output image is billed at the tier’s price.

Rules

• optimize_prompt_options is allowed only with optimize_prompt set to true.

Input fields

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

Example

A complete create request, the 202 answer and the task once it has succeeded.

Request

curl https://api.vizoapi.com/v1/generations \
  -H "Authorization: Bearer $VIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro",
  "input": {
    "prompt": "A paper boat on a pond at dawn, soft watercolor"
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}'

import os, requests

# Send once: do not retry this request automatically.
task = requests.post(
    "https://api.vizoapi.com/v1/generations",
    headers={"Authorization": f"Bearer {os.environ['VIZO_API_KEY']}"},
    json={
      "model": "seedream-5-0-pro",
      "input": {
        "prompt": "A paper boat on a pond at dawn, soft watercolor"
      },
      "metadata": {
        "client_reference": "my-unique-reference-1"
      }
    },
    timeout=60,
).json()
print(task["id"], task["status"])

// Send once: do not retry this request automatically.
const res = await fetch("https://api.vizoapi.com/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VIZO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "seedream-5-0-pro",
    "input": {
      "prompt": "A paper boat on a pond at dawn, soft watercolor"
    },
    "metadata": {
      "client_reference": "my-unique-reference-1"
    }
  }),
});
const task = await res.json();
console.log(task.id, task.status);

Response

{
  "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
}

{
  "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"
      }
    ]
  }
}