# Seedream 5.0 Pro Global Image Generation

> Image Generation

Generate images from a prompt. Seedream 5.0 Pro Global supports:
- Single image generation (no sequential/group generation)
- Up to 10 reference images
- Layer decomposition mode
- Transparent background output
- Multi-language prompts

## Endpoint

`POST https://api.modelverse.cn/images/generations`

## Request Body

## Responses

- **200** — Image generation response.
- **400** — Invalid request parameters or image generation error.
- **default** — Error response.

## OpenAPI Definition

```json
{
  "openapi": "3.1.0",
  "x-language": "en-US",
  "info": {
    "title": "Seedream 5.0 Pro Global Image Generation API",
    "version": "1.0.0",
    "description": "Image generation API for Seedream 5.0 Pro (Global) model.\nEndpoint: POST https://api.modelverse.cn/v1/images/generations\n\nModel capabilities:\n- Supports single image generation only\n- Supports up to 10 reference images\n- Supports multi-language prompts: Chinese, English, Russian, Arabic, Filipino, Thai, Turkish, Korean, Malay, Spanish, Portuguese, Indonesian, French, German, Vietnamese, Japanese\n- Supports layer decomposition and transparent background\n- Does NOT support: sequential image generation, streaming output, web search tools\n"
  },
  "servers": [
    {
      "url": "https://api.modelverse.cn/v1",
      "description": "ModelVerse API endpoint for Seedream 5.0 Pro Global."
    }
  ],
  "tags": [
    {
      "name": "doubao-seedream-5-0-pro-260628-global",
      "description": "Image generation with Seedream 5.0 Pro (doubao-seedream-5-0-pro-260628-global)."
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/images/generations": {
      "post": {
        "tags": [
          "doubao-seedream-5-0-pro-260628-global"
        ],
        "operationId": "createSeedream50ProGlobalImageGeneration",
        "summary": "Seedream 5.0 Pro Global Image Generation",
        "description": "Generate images from a prompt. Seedream 5.0 Pro Global supports:\n- Single image generation (no sequential/group generation)\n- Up to 10 reference images\n- Layer decomposition mode\n- Transparent background output\n- Multi-language prompts\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Seedream50ProGlobalGenerationRequest"
              },
              "examples": {
                "basicGeneration": {
                  "summary": "Basic image generation",
                  "value": {
                    "model": "doubao-seedream-5-0-pro-260628-global",
                    "prompt": "A beautiful sunset over the ocean with golden clouds",
                    "size": "2k",
                    "response_format": "url",
                    "watermark": false
                  }
                },
                "withReferenceImage": {
                  "summary": "Generation with reference image",
                  "value": {
                    "model": "doubao-seedream-5-0-pro-260628-global",
                    "prompt": "Transform this image into a pencil sketch style",
                    "images": [
                      "data:image/png;base64,iVBORw0KGgo..."
                    ],
                    "size": "2048x2048",
                    "output_format": "png",
                    "response_format": "url",
                    "watermark": false
                  }
                },
                "layerDecomposition": {
                  "summary": "Layer decomposition mode",
                  "value": {
                    "model": "doubao-seedream-5-0-pro-260628-global",
                    "prompt": "Decompose this image into editable layers",
                    "images": [
                      "https://example.com/image.png"
                    ],
                    "size": "2k",
                    "layer_decomposition": true,
                    "output_format": "png",
                    "response_format": "url"
                  }
                },
                "transparentBackground": {
                  "summary": "Generate with transparent background",
                  "value": {
                    "model": "doubao-seedream-5-0-pro-260628-global",
                    "prompt": "A cute cartoon character",
                    "images": [
                      "data:image/png;base64,iVBORw0KGgo..."
                    ],
                    "size": "2k",
                    "background": "transparent",
                    "output_format": "png",
                    "response_format": "url"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Image generation response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Seedream50ProGlobalGenerationResponse"
                },
                "examples": {
                  "urlImage": {
                    "summary": "Generated image returned as a URL",
                    "value": {
                      "model": "doubao-seedream-5-0-pro-260628-global",
                      "created": 1767939740,
                      "data": [
                        {
                          "url": "https://xxxxxx",
                          "size": "2048x2048"
                        }
                      ],
                      "usage": {
                        "generated_images": 1,
                        "output_tokens": 16384,
                        "total_tokens": 16384
                      }
                    }
                  },
                  "base64Image": {
                    "summary": "Generated image returned as Base64 JSON",
                    "value": {
                      "model": "doubao-seedream-5-0-pro-260628-global",
                      "created": 1767939740,
                      "data": [
                        {
                          "b64_json": "{image_base64_string}",
                          "size": "2048x2048"
                        }
                      ],
                      "usage": {
                        "generated_images": 1,
                        "output_tokens": 16384,
                        "total_tokens": 16384
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid request parameters or image generation error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Seedream50ProGlobalErrorResponse"
                },
                "examples": {
                  "invalidParameter": {
                    "summary": "Invalid parameter error",
                    "value": {
                      "error": {
                        "code": "invalid_parameter",
                        "message": "The parameter 'stream' is not supported for this model."
                      }
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Seedream50ProGlobalErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API key",
        "description": "BytePlus API key sent in the `Authorization: Bearer <API_KEY>` header.\n"
      }
    },
    "schemas": {
      "Seedream50ProGlobalGenerationRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model",
          "prompt"
        ],
        "properties": {
          "model": {
            "type": "string",
            "const": "doubao-seedream-5-0-pro-260628-global",
            "description": "Model ID. Must be `doubao-seedream-5-0-pro-260628-global` for Seedream 5.0 Pro Global.\n"
          },
          "prompt": {
            "type": "string",
            "minLength": 1,
            "description": "Text prompt used to generate an image.\n\nLanguage support: Chinese, English, Russian, Arabic, Filipino, Thai, Turkish, Korean, Malay, Spanish, Portuguese, Indonesian, French, German, Vietnamese, Japanese.\n\nLength recommendation: No more than 300 Chinese characters or 600 English words.\n"
          },
          "images": {
            "type": "array",
            "description": "Reference image inputs (max 10). Each item can be an accessible URL or a Base64 data URL.\n",
            "items": {
              "type": "string"
            },
            "maxItems": 10
          },
          "image": {
            "type": "string",
            "description": "Single reference image input. Can be an accessible URL or a Base64 data URL.\n"
          },
          "layer_decomposition": {
            "type": "boolean",
            "default": false,
            "description": "Enable layer decomposition mode."
          },
          "size": {
            "type": "string",
            "description": "Image dimensions (2K, 4K, or explicit WxH).",
            "default": "2048x2048"
          },
          "optimize_prompt_options": {
            "type": "object",
            "properties": {
              "mode": {
                "type": "string",
                "enum": [
                  "standard",
                  "fast"
                ],
                "default": "standard"
              }
            }
          },
          "output_format": {
            "type": "string",
            "enum": [
              "png",
              "jpeg"
            ],
            "default": "jpeg"
          },
          "background": {
            "type": "string",
            "enum": [
              "transparent",
              "opaque"
            ],
            "default": "opaque",
            "description": "Controls transparent background output."
          },
          "response_format": {
            "type": "string",
            "enum": [
              "url",
              "b64_json"
            ],
            "default": "url"
          },
          "watermark": {
            "type": "boolean",
            "default": true
          }
        }
      },
      "Seedream50ProGlobalGenerationResponse": {
        "type": "object",
        "required": [
          "model",
          "created",
          "data",
          "usage"
        ],
        "properties": {
          "model": {
            "type": "string"
          },
          "created": {
            "type": "integer",
            "format": "int64"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Seedream50ProGlobalImageData"
            }
          },
          "usage": {
            "$ref": "#/components/schemas/Seedream50ProGlobalUsage"
          }
        }
      },
      "Seedream50ProGlobalImageData": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "b64_json": {
            "type": "string"
          },
          "size": {
            "type": "string"
          }
        }
      },
      "Seedream50ProGlobalUsage": {
        "type": "object",
        "required": [
          "generated_images",
          "output_tokens",
          "total_tokens"
        ],
        "properties": {
          "generated_images": {
            "type": "integer",
            "description": "Number of images generated."
          },
          "input_images": {
            "type": "integer",
            "description": "Number of input images."
          },
          "output_tokens": {
            "type": "integer",
            "description": "Number of output tokens consumed."
          },
          "total_tokens": {
            "type": "integer",
            "description": "Total tokens consumed (input + output)."
          }
        }
      },
      "Seedream50ProGlobalErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "$ref": "#/components/schemas/Seedream50ProGlobalError"
          }
        }
      },
      "Seedream50ProGlobalError": {
        "type": "object",
        "required": [
          "code",
          "message"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
```