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

# Seedream 5.5

> Seedream 5.5 text-to-image and image-to-image. Pass `image_list` to use reference images (up to 10), or omit it for pure text-to-image. Always returns a single image.

To split an image into editable layers, use the separate [seedream-5-5-layers](./seedream-5-5-layers) model instead.

#### Transparent output

Set `background` to `transparent` to get a real alpha-channel background. It works for text-to-image and with reference images, and the inputs do not need to be transparent. Set it to `auto` to let the model decide; the result tells you which background it used. Both output png.

#### Pricing

| What | Tokens | USD |
|---|---|---|
| Output, 1K or 1.5K | 1.04 | $0.0208 |
| Output, 2K | 1.82 | $0.0364 |
| Each reference image | 0.42 | $0.0084 |

Example: a 2K image with 3 reference images costs 1.82 + 3 × 0.42 = 3.08 tokens.

Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use `custom_callback_url`) to get the generated image.



## OpenAPI

````yaml api-reference/image-api/openapi-seedream-5-5.json POST /api/v1/images/generations
openapi: 3.1.0
info:
  title: GoEnhance API - Seedream 5.5
  description: Seedream 5.5
  version: 1.0.0
servers:
  - url: https://api.goenhance.ai
security: []
paths:
  /api/v1/images/generations:
    post:
      tags:
        - ImageAPI
      summary: Seedream 5.5
      description: >-
        Seedream 5.5 text-to-image and image-to-image. Pass `image_list` to use
        reference images (up to 10), or omit it for pure text-to-image. Always
        returns a single image.


        To split an image into editable layers, use the separate
        [seedream-5-5-layers](./seedream-5-5-layers) model instead.


        #### Transparent output


        Set `background` to `transparent` to get a real alpha-channel
        background. It works for text-to-image and with reference images, and
        the inputs do not need to be transparent. Set it to `auto` to let the
        model decide; the result tells you which background it used. Both output
        png.


        #### Pricing


        | What | Tokens | USD |

        |---|---|---|

        | Output, 1K or 1.5K | 1.04 | $0.0208 |

        | Output, 2K | 1.82 | $0.0364 |

        | Each reference image | 0.42 | $0.0084 |


        Example: a 2K image with 3 reference images costs 1.82 + 3 × 0.42 = 3.08
        tokens.


        Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use
        `custom_callback_url`) to get the generated image.
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: false
          example: '{{Authorization}}'
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  enum:
                    - seedream-5-5
                  description: Model name. Must be `seedream-5-5`.
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 4000
                  description: Text prompt describing the image.
                ratio:
                  type: string
                  enum:
                    - auto
                    - '1:1'
                    - '2:3'
                    - '3:2'
                    - '3:4'
                    - '4:3'
                    - '4:5'
                    - '5:4'
                    - '9:16'
                    - '16:9'
                    - '21:9'
                    - '9:21'
                  description: >-
                    Output aspect ratio. Defaults to auto, which lets the model
                    choose the framing from your prompt.
                  default: auto
                image_size:
                  type: string
                  enum:
                    - 1K
                    - 1.5K
                    - 2K
                  default: 2K
                  description: >-
                    Output quality tier. 1K and 1.5K cost the same; 2K costs
                    more. Defaults to 2K.
                image_list:
                  type: array
                  items:
                    type: object
                    properties:
                      url:
                        type: string
                        format: uri
                    required:
                      - url
                  description: >-
                    Optional reference images for image-to-image or editing,
                    [{"url": "https://..."}]. Up to 10 images, each up to 30MB.
                    Each reference image adds an input fee.
                  minItems: 1
                  maxItems: 10
                background:
                  type: string
                  enum:
                    - opaque
                    - transparent
                    - auto
                  default: opaque
                  description: >-
                    `opaque` (default) gives a solid background. `transparent`
                    gives a real alpha channel, with or without input images.
                    `auto` lets the model decide, and the result reports
                    `background` as `transparent` or `opaque`. `transparent` and
                    `auto` output png; combining them with `output_format: jpeg`
                    is rejected.
                output_format:
                  type: string
                  enum:
                    - png
                    - jpeg
                  default: jpeg
                  description: >-
                    Output file format. Defaults to png when `background` is
                    `transparent` or `auto`.
                custom_callback_url:
                  type: string
                  format: uri
                  description: >-
                    Optional. A publicly accessible HTTPS URL. When the task
                    status changes (processing / success / failed), GoEnhance
                    sends a POST request to this URL. The request body is
                    identical to the response of GET /api/v1/jobs/detail. If
                    your server does not respond with HTTP 200, the notification
                    is retried up to 3 times, with a 3-second timeout per
                    attempt.
                  example: https://your-server.com/goenhance/callback
              required:
                - model
                - prompt
            example:
              model: seedream-5-5
              prompt: A glass perfume bottle on a marble table, soft studio light
              image_size: 2K
              ratio: '4:5'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    type: object
                    properties:
                      img_uuid:
                        type: string
                      cost:
                        type: number
                        description: >-
                          Tokens deducted for this request. This is the amount
                          actually charged, so it already reflects any discount
                          active on your account and can be lower than the
                          listed price. Tokens are deducted when the task is
                          accepted, and refunded automatically if the generation
                          ends in failure.
                        example: 1.82
                    required:
                      - img_uuid
                      - cost
                required:
                  - code
                  - msg
                  - data
              examples:
                '1':
                  summary: Success
                  value:
                    code: 0
                    msg: Success
                    data:
                      img_uuid: c12b656c-747a-44fd-9c80-add79b0c52d5
                      cost: 1.82
                '2':
                  summary: Insufficient tokens
                  value:
                    code: 100
                    msg: tokens is not enough
                quota:
                  summary: API key quota exceeded
                  value:
                    code: 101
                    msg: 'API key quota exceeded: 4990 of 5000 tokens used (monthly)'
          headers: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                required:
                  - code
                  - msg
          headers: {}
      deprecated: false
      security: []

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.