Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt

Use this file to discover all available pages before exploring further.

Model ID 
seedream-5.0-lite

​
Seedream-5.0-lite API Documentation

Seedream-5.0-lite is a next-generation multimodal image generation model by Byteplus. It supports text, single-image, and multi-image inputs, offering high-fidelity outputs with consistent subject generation.

​
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

  • Max Input Images: 14 reference images
  • Max Output Images: 15 (Total of reference + generated)
  • Output Formats: jpeg (default), png (Exclusive to 5.0-lite)

​
3. Image Dimension Methods (Mutually Exclusive)

​
Method 1: Intelligence Presets

Specify a preset and describe the desired aspect ratio/shape in the text prompt.
  • Options: 2K, 3K

​
Method 2: Custom Pixel Dimensions

Specify exact width and height (e.g., “3750x1250”). Constraints:
  • Total Pixels (W x H): Must be between 3,686,400 and 10,404,496.
  • Aspect Ratio (W / H): Must be between 0.0625 (1:16) and 16.0 (16:1).

​
4. Parameter Reference

ParameterTypeRequiredDescription
promptstringYesText description (< 600 words recommended).
imagearrayNoArray of reference image URLs (up to 14).
sizestringNoPreset (2K, 3K) or custom (WxH). Default: 2048x2048.
output_formatstringNojpeg or png.
max_imagesintegerNoTotal images allowed (up to 15).
sequential_image_generationstringNoauto (for consistency) or disabled.
watermarkbooleanNoToggle “AI Generated” watermark. Default: false.

​
5. Example CURL Request

curl -X POST "[https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests](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-lite",
    "payload": {
      "prompt": "A cinematic widescreen shot of a futuristic neon city",
      "size": "2560x1440",
      "output_format": "png",
      "max_images": 1,
      "watermark": false
    }
  }'

​
6. Checking Request Status

Endpoint: GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
  • queued: Waiting in line.
  • processing: Generating image.
  • success: Completed. Find URLs in outcome.media_urls.