> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedream-4.5 Image Generation

> Advanced image generation model with support for text-to-image, image-to-image, and multi-image reference capabilities

<Tip>
  1. After submission, a `task_id` will be returned. If you provided a `callback_url`, when the task status becomes `finished` or `failed`, a POST request will be sent to the `callback_url`.
  2. Regardless of whether `callback_url` is provided, you can retrieve the response result through the unified [Query Task Status](/api-manual/task-management/status) endpoint.
</Tip>

# Seedream-4.5 Image Generation

Seedream-4.5 is an advanced image generation model that supports text-to-image, image-to-image, and image editing with multi-reference capabilities. It delivers high-quality images with flexible aspect ratios and prompt optimization options.

## Available Models

* **seedream-4.5** - High-quality text-to-image and image-to-image generation
* **seedream-4.5-edit** - Advanced image editing with multi-image reference support (up to 10 images)


## OpenAPI

````yaml /api-manual/image-series/seedream-4-5.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: Vidgo API - Seedream-4.5 API
  description: >-
    Advanced image generation model with support for text-to-image,
    image-to-image, and multi-image reference capabilities
  version: 1.0.0
servers:
  - url: https://api.vidgo.ai
    description: Production server
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Seedream-4.5
      summary: Submit Seedream-4.5 Generation Task
      description: >-
        Advanced image generation and editing with multi-reference support and
        up to 4K resolution
      operationId: submitSeedream45Task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitRequest'
            examples:
              seedream-4-5:
                summary: Seedream-4.5 Text-to-Image Generation
                value:
                  model: seedream-4.5
                  callback_url: https://your-domain.com/callback
                  input:
                    prompt: >-
                      A serene Japanese garden with cherry blossoms and a koi
                      pond
                    size: '16:9'
                    'n': 1
              seedream-4-5-edit:
                summary: Seedream-4.5 Image Editing with References
                value:
                  model: seedream-4.5-edit
                  callback_url: https://your-domain.com/callback
                  input:
                    prompt: Transform the scene to a winter wonderland with snow
                    image_urls:
                      - https://example.com/reference1.jpg
                      - https://example.com/reference2.jpg
                    size: '16:9'
                    'n': 1
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                code: 400
                error:
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                code: 401
                error:
                  message: Unauthorized - Invalid API key
                  type: authentication_error
components:
  schemas:
    SubmitRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          description: Seedream-4.5 model identifier
          enum:
            - seedream-4.5
            - seedream-4.5-edit
        callback_url:
          type: string
          format: uri
          description: Webhook callback URL for result notifications
          example: https://your-domain.com/callback
        input:
          type: object
          required:
            - prompt
          description: Input parameters for generation
          properties:
            prompt:
              type: string
              description: Generation prompt describing the desired output
              maxLength: 2000
              example: A beautiful sunset over the ocean
            image_urls:
              type: array
              items:
                type: string
                format: uri
              minItems: 1
              maxItems: 10
              description: >-
                Reference image URLs for image-to-image or editing (1-10
                images). Required for seedream-4.5-edit model. Supported
                formats: JPEG, PNG
              example:
                - https://example.com/reference1.jpg
                - https://example.com/reference2.jpg
            size:
              type: string
              description: >-
                Specify the output image dimensions. Two methods are available,
                but they cannot be used at the same time.


                Method 1: Specify the resolution of the generated image, and
                describe its aspect ratio, shape, or purpose in the prompt using
                natural language. You let the model determine the width and
                height. Optional values: 2K, 4K


                Method 2: Specify the aspect ratio of the generated image.
                Optional values: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9
              enum:
                - 2K
                - 4K
                - '1:1'
                - '4:3'
                - '3:4'
                - '16:9'
                - '9:16'
                - '3:2'
                - '2:3'
                - '21:9'
              default: '1:1'
              example: '16:9'
            'n':
              type: integer
              description: >-
                Number of images to generate (1-15). Credits are pre-deducted
                based on this count
              minimum: 1
              maximum: 15
              default: 1
              example: 1
    SubmitResponse:
      type: object
      required:
        - code
        - data
      properties:
        code:
          type: integer
          example: 200
          description: HTTP status code
        data:
          type: object
          required:
            - task_id
            - status
            - created_time
          properties:
            task_id:
              type: string
              example: task-unified-1757165031-uyujaw3d
              description: Unique task identifier for status tracking
            status:
              type: string
              enum:
                - not_started
              example: not_started
              description: Initial task status
            created_time:
              type: string
              format: date-time
              example: '2025-11-12T10:30:00'
              description: ISO 8601 timestamp when the task was created
    ErrorResponse:
      type: object
      required:
        - code
        - error
      properties:
        code:
          type: integer
          example: 400
          description: HTTP status code
        error:
          type: object
          required:
            - message
            - type
          properties:
            message:
              type: string
              example: Invalid request parameters
              description: Error message describing what went wrong
            type:
              type: string
              example: invalid_request_error
              description: Error type identifier
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        All API endpoints require Bearer Token authentication


        Get your API Key:


        Visit the [API Key Management
        Page](https://vidgo.ai/apis/dashboard/api-key) to get your API Key


        Add it to the request header:


        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````