> ## 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-5.0-Lite Image Generation

> Seedream 5.0 Lite image generation and editing with preset sizes, custom dimensions, and up to 10 reference images

<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-5.0-Lite Image Generation

Seedream-5.0-Lite is an image generation and editing model for async production workflows. It supports text-to-image, reference-based editing, flexible preset sizes, and custom dimensions through the same unified Vidgo API submit and status endpoints.

## Available Models

* **seedream-5.0-lite** - Text-to-image and image-to-image generation with preset or custom output sizes
* **seedream-5.0-lite-edit** - Image editing with 1 to 10 JPEG or PNG reference images

## Request Notes

* `model` must be `seedream-5.0-lite` or `seedream-5.0-lite-edit`
* `input.prompt` is required and supports up to 2000 characters
* `input.n` accepts integers from `1` to `15`
* `input.image_urls` is optional for `seedream-5.0-lite` image-to-image requests and required for `seedream-5.0-lite-edit`; both accept `1` to `10` URLs
* successful submit responses return `task_id` and `created_time`; query final task state through the unified status endpoint

## Size Parameter

`input.size` supports four accepted forms:

1. Resolution presets such as `2K` and `3K`
2. Ratio presets such as `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3`, and `21:9`
3. Custom size strings such as `2304x1728`
4. Structured JSON objects such as `{ "width": 2304, "height": 1728 }`

Object-style `size` is supported for both `seedream-5.0-lite` and `seedream-5.0-lite-edit`.

Use preset sizes when you want quick resolution or aspect-ratio control. Use custom strings or objects when your workflow needs exact dimensions.

## Custom Size Example

```json theme={null}
{
  "model": "seedream-5.0-lite",
  "input": {
    "prompt": "A cinematic bookstore interior with clean bilingual signage and soft blue-hour light",
    "size": {
      "width": 2304,
      "height": 1728
    },
    "n": 1
  }
}
```

## Edit Mode Example

```json theme={null}
{
  "model": "seedream-5.0-lite-edit",
  "input": {
    "prompt": "Keep the composition and convert the scene into a snowy evening with warmer storefront light",
    "image_urls": [
      "https://example.com/reference1.jpg",
      "https://example.com/reference2.jpg"
    ],
    "size": "2304x1728",
    "n": 1
  }
}
```

## Error Response Shape

Validation and authentication failures follow the unified Vidgo API error shape:

```json theme={null}
{
  "detail": "prompt is required"
}
```


## OpenAPI

````yaml /api-manual/image-series/seedream-5-0-lite.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: Vidgo API - Seedream-5.0-Lite API
  description: >-
    Seedream 5.0 Lite image generation and editing with preset sizes, custom
    dimensions, and up to 10 reference images
  version: 1.0.0
servers:
  - url: https://api.vidgo.ai
    description: Production server
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Seedream-5.0-Lite
      summary: Submit Seedream-5.0-Lite Generation Task
      description: >-
        Submit text-to-image or image editing tasks with preset sizes, custom
        size strings, or structured width and height objects
      operationId: submitSeedream50LiteTask
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitRequest'
            examples:
              seedream-5-0-lite:
                summary: Seedream-5.0-Lite Text-to-Image Generation
                value:
                  model: seedream-5.0-lite
                  callback_url: https://your-domain.com/callback
                  input:
                    prompt: >-
                      A serene Japanese garden with cherry blossoms and a koi
                      pond
                    size: 2K
                    'n': 1
              seedream-5-0-lite-edit:
                summary: Seedream-5.0-Lite Image Editing with References
                value:
                  model: seedream-5.0-lite-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: 2304x1728
                    'n': 1
              seedream-5-0-lite-custom-object-size:
                summary: Seedream-5.0-Lite with Structured Size Object
                value:
                  model: seedream-5.0-lite
                  callback_url: https://your-domain.com/callback
                  input:
                    prompt: >-
                      A futuristic bookstore interior with clean bilingual
                      wayfinding and soft blue-hour lighting
                    size:
                      width: 2304
                      height: 1728
                    'n': 1
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
              example:
                code: 200
                data:
                  task_id: KC9IIO8MLOAN18JX
                  created_time: '2026-04-16T18:36:35'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: prompt is required
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Invalid API key
components:
  schemas:
    SubmitRequest:
      oneOf:
        - $ref: '#/components/schemas/LiteSubmitRequest'
        - $ref: '#/components/schemas/LiteEditSubmitRequest'
      discriminator:
        propertyName: model
        mapping:
          seedream-5.0-lite:
            $ref: '#/components/schemas/LiteSubmitRequest'
          seedream-5.0-lite-edit:
            $ref: '#/components/schemas/LiteEditSubmitRequest'
    SubmitResponse:
      type: object
      required:
        - code
        - data
      properties:
        code:
          type: integer
          example: 200
          description: HTTP status code
        data:
          type: object
          required:
            - task_id
            - created_time
          properties:
            task_id:
              type: string
              example: task-unified-1757165031-uyujaw3d
              description: Unique task identifier for status tracking
            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:
        - detail
      properties:
        detail:
          type: string
          example: prompt is required
          description: Error message describing what went wrong
    LiteSubmitRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          enum:
            - seedream-5.0-lite
          description: Seedream-5.0-Lite text-to-image model identifier
        callback_url:
          type: string
          format: uri
          description: Webhook callback URL for result notifications
          example: https://your-domain.com/callback
        input:
          $ref: '#/components/schemas/LiteInput'
    LiteEditSubmitRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          enum:
            - seedream-5.0-lite-edit
          description: Seedream-5.0-Lite edit model identifier
        callback_url:
          type: string
          format: uri
          description: Webhook callback URL for result notifications
          example: https://your-domain.com/callback
        input:
          $ref: '#/components/schemas/LiteEditInput'
    LiteInput:
      type: object
      required:
        - prompt
      description: >-
        Input parameters for Seedream-5.0-Lite text-to-image or image-to-image
        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: >-
            Optional reference image URLs for image-to-image generation on
            seedream-5.0-lite. Supported formats: JPEG, PNG
          example:
            - https://example.com/reference1.jpg
        size:
          $ref: '#/components/schemas/SizeParameter'
        '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
    LiteEditInput:
      type: object
      required:
        - prompt
        - image_urls
      description: Input parameters for Seedream-5.0-Lite edit generation
      properties:
        prompt:
          type: string
          description: Editing prompt describing the desired transformation
          maxLength: 2000
          example: Transform the scene to a winter wonderland with snow
        image_urls:
          type: array
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 10
          description: >-
            Reference image URLs for edit mode. Required for
            seedream-5.0-lite-edit. Supported formats: JPEG, PNG
          example:
            - https://example.com/reference1.jpg
            - https://example.com/reference2.jpg
        size:
          $ref: '#/components/schemas/SizeParameter'
        '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
    SizeParameter:
      description: >-
        Optional output size. Supports resolution presets, ratio presets, custom
        WIDTHxHEIGHT strings, or a JSON object with width and height.
      oneOf:
        - type: string
          description: Resolution preset or aspect-ratio preset
          enum:
            - 2K
            - 3K
            - '1:1'
            - '4:3'
            - '3:4'
            - '16:9'
            - '9:16'
            - '3:2'
            - '2:3'
            - '21:9'
          example: '16:9'
        - type: string
          description: Custom dimensions as WIDTHxHEIGHT
          pattern: ^\d+[xX]\d+$
          example: 2304x1728
        - type: object
          description: Structured custom dimensions
          required:
            - width
            - height
          properties:
            width:
              type: integer
              minimum: 1
              example: 2304
            height:
              type: integer
              minimum: 1
              example: 1728
          additionalProperties: false
          example:
            width: 2304
            height: 1728
  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

        ```

````