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

# Text-to-Image (Sync)

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

<Note>
  This is a **synchronous** endpoint compatible with OpenAI `POST /v1/images/generations`. On success, billing is applied immediately and image results are returned in `data` (`b64_json` or `url`) — no task polling required.

  Unlike [Create Image Task](/en/api-reference/images/create) (async `POST /images`), which returns a `task_id` and requires [Query Image Task](/en/api-reference/images/query).
</Note>

<Warning>
  Generation often takes **30–120 seconds**. Set client timeout to **≥ 180 seconds**. Responses may include multi‑MB `b64_json`; ensure your client and any proxy support large bodies.
</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

````