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

# 文生图（同步）

> 同步文生图，兼容 OpenAI POST /v1/images/generations。成功响应后立即扣费，在 data 中返回图片结果，无需轮询。

<Note>
  本接口为**同步**调用，兼容 OpenAI `POST /v1/images/generations`。请求成功后**立即扣费**，并在响应 `data` 中直接返回图片结果（`b64_json` 或 `url`），无需轮询任务。

  与 [创建图片任务](/zh/api-reference/images/create)（异步，`POST /images`）不同：异步接口返回 `task_id`，需通过 [查询图片任务](/zh/api-reference/images/query) 获取结果。
</Note>

<Warning>
  图片生成通常需要 **30–120 秒**。请将客户端超时设置为 **≥ 180 秒**，避免中途断开。`b64_json` 体积可能达数 MB，请确保调用方与网关支持大响应体。
</Warning>


## OpenAPI

````yaml POST /api/open-api/v1/images/generations
openapi: 3.1.0
info:
  title: Jimmy AI OpenAPI
  description: API for Jimmy AI video generation services
  version: 1.0.0
servers:
  - url: https://www.jimmyai.cn
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/open-api/v1/images/generations:
    post:
      summary: Text-to-Image (Sync)
      description: >-
        Synchronous text-to-image, compatible with OpenAI POST
        /v1/images/generations. Billed on success; returns image results in data
        without polling.
      operationId: generateOpenAIImage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenAIImageGenerationRequest'
      responses:
        '200':
          description: Generation successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIImageSyncResponse'
components:
  schemas:
    OpenAIImageGenerationRequest:
      type: object
      required:
        - prompt
      properties:
        model:
          type: string
          description: 'Model name. Default: gpt-image-2'
          default: gpt-image-2
          example: gpt-image-2
        prompt:
          type: string
          description: Text prompt for image generation
        size:
          type: string
          description: 'Output size. Default: 1024x1024'
          default: 1024x1024
          example: 1024x1024
        'n':
          type: integer
          description: 'Number of images. MAX: 1'
          default: 1
        quality:
          type: string
          description: Quality tier (affects billing for gpt-image-2)
          enum:
            - low
            - medium
            - high
            - auto
          default: low
        background:
          type: string
          enum:
            - transparent
            - opaque
            - auto
        output_format:
          type: string
          enum:
            - png
            - jpeg
            - webp
      example:
        model: gpt-image-2
        prompt: Cyberpunk city at night in the rain, neon signs, cinematic framing
        size: 1024x1024
        'n': 1
        quality: high
    OpenAIImageSyncResponse:
      type: object
      properties:
        code:
          type: integer
          example: 20000
        msg:
          type: string
          example: ok
        data:
          $ref: '#/components/schemas/OpenAIImageSyncResult'
    OpenAIImageSyncResult:
      type: object
      description: OpenAI-compatible image result
      properties:
        created:
          type: integer
          format: int64
        data:
          type: array
          items:
            $ref: '#/components/schemas/OpenAIImageResultItem'
        model:
          type: string
          example: gpt-image-2
        usage:
          $ref: '#/components/schemas/OpenAIImageUsage'
    OpenAIImageResultItem:
      type: object
      properties:
        b64_json:
          type: string
          description: Base64-encoded image (may be several MB)
        revised_prompt:
          type: string
    OpenAIImageUsage:
      type: object
      properties:
        input_tokens:
          type: integer
        output_tokens:
          type: integer
        total_tokens:
          type: integer
        input_tokens_details:
          type: object
          properties:
            image_tokens:
              type: integer
            text_tokens:
              type: integer
        output_tokens_details:
          type: object
          properties:
            image_tokens:
              type: integer
            text_tokens:
              type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````