Model ID

seedream-5.0-pro

Calling method: sync

Seedream 5.0 Pro API Documentation

Seedream 5.0 Pro is Byteplus’s next-generation image generation model. It supports text-to-image, single-image, and multi-image (up to 14 reference images) inputs, high-resolution output up to 3K, and optional sequential generation of related images.

1. API Endpoint & Authentication

Base URL: https://console.gmicloud.ai Endpoint: POST /api/v1/ie/requestqueue/apikey/requests Header: Authorization: Bearer YOUR_API_KEY Content-Type: application/json

2. Model Specifications

Pricing: $0.085 per image
Input: Text prompt (required), plus up to 14 optional reference images
Resolution: 2K / 3K presets, or explicit WxH (total pixels 3.6M-10.4M; aspect ratio 1/16 to 16)
Output Formats: JPEG (default) or PNG
Features: Multi-image reference, sequential image generation, optional AI-generated watermark

3. How It Works

Text-to-Image & Image-to-Image

Provide a text prompt (recommended under 600 words) to generate an image from scratch. Optionally supply one or more reference images to guide the output. Up to 14 reference images are supported, passed as a single URL or an array of URLs.

Size Control

Output size can be set two ways: a preset tier (‘2K’ or ‘3K’), or an explicit ‘WxH’ dimension. Explicit dimensions must total between 3.6M and 10.4M pixels with an aspect ratio between 1/16 and 16. The default is 2048x2048.

Sequential Image Generation

When set to ‘auto’, the model can generate a sequence of related images in one request rather than a single image. The max_images value caps the total, where reference images plus generated images must not exceed 15.

Output Format & Watermark

Choose JPEG or PNG output. When watermark is enabled, an ‘AI Generated’ label is added to the bottom-right corner of each image.

4. Parameter Reference

Parameter	Type	Required	Description
prompt	string	Yes	Text prompt for image generation (recommended under 600 words).
image	image	No	Reference image URL or array of URLs (JPEG/PNG). Up to 14 supported.
size	enum	No	’2K’/‘3K’ preset, or ‘WxH’. Default: “2048x2048”.
sequential_image_generation	enum	No	’disabled’ or ‘auto’. Default: “disabled”.
max_images	integer	No	Total (reference + generated) less than or equal to 15. Default: 1.
output_format	enum	No	’jpeg’ or ‘png’. Default: “jpeg”.
watermark	boolean	No	Add an ‘AI Generated’ watermark. Default: false.

5. Example CURL Request

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-pro",
    "payload": {
      "prompt": "A cinematic shot of a dragon taking flight from a cliffside.",
      "size": "2K",
      "output_format": "jpeg",
      "watermark": false
    }
  }'

6. Checking Request Status

Endpoint: GET /api/v1/ie/requestqueue/apikey/requests/{request_id}

queued: Request is waiting to be processed by GPU resources.
processing: Image generation is currently in progress.
success: Generation completed. URLs available in outcome.media_urls.
failed: Generation failed. Check logs for details.

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

seedream-5.0-pro

Seedream 5.0 Pro API Documentation

1. API Endpoint & Authentication

2. Model Specifications

3. How It Works

Text-to-Image & Image-to-Image

Size Control

Sequential Image Generation

Output Format & Watermark

4. Parameter Reference

5. Example CURL Request

6. Checking Request Status

​Seedream 5.0 Pro API Documentation

​1. API Endpoint & Authentication

​2. Model Specifications

​3. How It Works

​Text-to-Image & Image-to-Image

​Size Control

​Sequential Image Generation

​Output Format & Watermark

​4. Parameter Reference

​5. Example CURL Request

​6. Checking Request Status

Seedream 5.0 Pro API Documentation

1. API Endpoint & Authentication

2. Model Specifications

3. How It Works

Text-to-Image & Image-to-Image

Size Control

Sequential Image Generation

Output Format & Watermark

4. Parameter Reference

5. Example CURL Request

6. Checking Request Status