> ## 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.

# MOSS-Image

> MOSS-Image text to image. The model is built for layout and long text, so posters, menus, signs and infographics come out with accurate English and Chinese lettering. Always returns a single PNG. Image editing is not available for this model; requests with `image_list` are rejected.

**Pricing** — flat per image by resolution tier:

| image_size | Tokens | USD |
|---|---|---|
| 1K (about 1 MP, default) | 1 | $0.02 |
| 2K (about 4 MP) | 4 | $0.08 |

**Text in the image** — put the exact words you want rendered in quotes, for example `a sign that reads "OPEN 24 HOURS"`. Chinese and English can be mixed in one prompt. Long prompts (up to 4000 characters) are fine and help with dense layouts. Text you do not specify may come out as filler.

**Timing** — about 15 to 20 seconds of processing for 1K, and about 1 to 2 minutes for 2K, plus queue time.



## OpenAPI

````yaml api-reference/image-api/openapi-moss-image.json POST /api/v1/images/generations
openapi: 3.1.0
info:
  title: GoEnhance API - MOSS-Image
  description: MOSS-Image
  version: 1.0.0
servers:
  - url: https://api.goenhance.ai
security: []
paths:
  /api/v1/images/generations:
    post:
      tags:
        - ImageAPI
      summary: MOSS-Image
      description: >-
        MOSS-Image text to image. The model is built for layout and long text,
        so posters, menus, signs and infographics come out with accurate English
        and Chinese lettering. Always returns a single PNG. Image editing is not
        available for this model; requests with `image_list` are rejected.


        **Pricing** — flat per image by resolution tier:


        | image_size | Tokens | USD |

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

        | 1K (about 1 MP, default) | 1 | $0.02 |

        | 2K (about 4 MP) | 4 | $0.08 |


        **Text in the image** — put the exact words you want rendered in quotes,
        for example `a sign that reads "OPEN 24 HOURS"`. Chinese and English can
        be mixed in one prompt. Long prompts (up to 4000 characters) are fine
        and help with dense layouts. Text you do not specify may come out as
        filler.


        **Timing** — about 15 to 20 seconds of processing for 1K, and about 1 to
        2 minutes for 2K, plus queue time.
      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:
                    - moss-image
                  description: Model name. Must be `moss-image`.
                prompt:
                  type: string
                  maxLength: 4000
                  description: >-
                    What to generate. Required. Text you put in quotes is
                    rendered in the image as written, in English or Chinese.
                ratio:
                  type: string
                  enum:
                    - auto
                    - '1:1'
                    - '2:3'
                    - '3:2'
                    - '3:4'
                    - '4:3'
                    - '9:16'
                    - '16:9'
                    - '21:9'
                  default: auto
                  description: Aspect ratio. `auto` means 1:1.
                image_size:
                  type: string
                  enum:
                    - 1K
                    - 2K
                  default: 1K
                  description: >-
                    Resolution tier, also the price tier. 1K is about 1
                    megapixel, 2K about 4 megapixels. Case-insensitive.
                seed:
                  type: integer
                  minimum: 0
                  maximum: 2147483647
                  description: Optional. Fixing the seed makes results more reproducible.
                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: moss-image
              prompt: >-
                A hand-drawn chalkboard cafe menu on a brick wall. Title in
                large white chalk letters: "MORNING LIGHT". Two columns:
                "COFFEE" Americano 18, Latte 24; "DESSERT" Croissant 16.
              ratio: '16:9'
              image_size: 1K
      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
                    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
                '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.