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

# 生成图像

> 根据文本提示词生成图像。



## OpenAPI

````yaml https://cdn.amux.ai/data/gpt-image-2-official.openapi.zh.json post /v1/images/generations
openapi: 3.1.0
info:
  title: amux 图像 API — gpt-image-2-official
  version: 1.0.0
  description: >-
    在 amux（https://api.amux.ai）上使用 `gpt-image-2-official` 模型进行图像生成与编辑，兼容 OpenAI
    图像接口。图像统一以 base64 返回（`data[].b64_json`）。
servers:
  - url: https://api.amux.ai
    description: amux API
security:
  - bearerAuth: []
tags:
  - name: images
    description: 图像生成与编辑
paths:
  /v1/images/generations:
    post:
      tags:
        - images
      summary: 生成图像
      description: 根据文本提示词生成图像。
      operationId: createImage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateImageRequest'
            examples:
              minimal:
                summary: 最小请求
                value:
                  model: gpt-image-2-official
                  prompt: 一只可爱的海獭幼崽
              full:
                summary: 常用参数
                value:
                  model: gpt-image-2-official
                  prompt: 日落时分的未来城市
                  'n': 1
                  size: 1536x1024
                  quality: high
                  background: opaque
                  output_format: jpeg
                  output_compression: 80
                  moderation: auto
                  user: user-1234
      responses:
        '200':
          description: 生成的图像。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImagesResponse'
              example:
                created: 1713833628
                background: opaque
                data:
                  - b64_json: <base64-png>
                output_format: png
                quality: high
                size: 1024x1024
                usage:
                  input_tokens: 13
                  input_tokens_details:
                    image_tokens: 0
                    text_tokens: 13
                  output_tokens: 8232
                  total_tokens: 8245
                  output_tokens_details:
                    image_tokens: 8192
                    text_tokens: 40
        '400':
          description: 请求无效。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: 缺少或无效的 API Key。
components:
  schemas:
    CreateImageRequest:
      type: object
      required:
        - prompt
      additionalProperties: false
      properties:
        prompt:
          type: string
          maxLength: 32000
          description: 所需图像的文本描述。
        model:
          type: string
          default: gpt-image-2-official
          enum:
            - gpt-image-2-official
        'n':
          type: integer
          minimum: 1
          maximum: 10
          default: 1
          description: 生成图像数量。
        size:
          type: string
          default: auto
          description: >-
            输出尺寸。预设：`1024x1024`、`1536x1024`、`1024x1536`、`auto`。也支持任意 `宽x高`：宽高均被
            16 整除、宽高比在 1:3 ~ 3:1 之间、且不超过模型上限（最大 3840x2160）。
          examples:
            - auto
            - 1024x1024
            - 1536x1024
            - 1024x1536
            - 1536x864
        quality:
          type: string
          enum:
            - low
            - medium
            - high
            - auto
          default: auto
          description: 渲染质量。
        background:
          type: string
          enum:
            - opaque
            - auto
          default: auto
          description: 背景处理。暂不支持透明背景。
        output_format:
          type: string
          enum:
            - png
            - jpeg
          default: png
          description: 输出图像格式。
        output_compression:
          type: integer
          minimum: 0
          maximum: 100
          default: 100
          description: 压缩级别（0-100%），对 `jpeg` 输出生效。
        moderation:
          type: string
          enum:
            - low
            - auto
          default: auto
          description: 内容审核强度。
        user:
          type: string
          description: 用于滥用监测的终端用户标识。
    ImagesResponse:
      type: object
      required:
        - created
        - data
      properties:
        created:
          type: integer
          description: Unix 时间戳（秒）。
        background:
          type: string
          enum:
            - opaque
        data:
          type: array
          items:
            $ref: '#/components/schemas/ImageObject'
        output_format:
          type: string
          enum:
            - png
            - jpeg
        quality:
          type: string
          enum:
            - low
            - medium
            - high
        size:
          type: string
          description: 实际渲染尺寸，如 `1024x1024`。
        usage:
          $ref: '#/components/schemas/Usage'
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            param:
              type: string
              nullable: true
            code:
              type: string
              nullable: true
    ImageObject:
      type: object
      properties:
        b64_json:
          type: string
          description: Base64 编码的图像字节。
    Usage:
      type: object
      required:
        - input_tokens
        - output_tokens
        - total_tokens
      properties:
        input_tokens:
          type: integer
        input_tokens_details:
          type: object
          properties:
            image_tokens:
              type: integer
            text_tokens:
              type: integer
        output_tokens:
          type: integer
        total_tokens:
          type: integer
        output_tokens_details:
          type: object
          properties:
            image_tokens:
              type: integer
            text_tokens:
              type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API Key 通过 `Authorization: Bearer <key>` 传入。'

````