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

# OpenAI Image Generation

> Interface description: Compatible endpoint (Vensen diagram) of OpenAI Images API `/v1/images/generations`. The request, response and error formats fully comply with the OpenAI specification: OpenAI original `ImagesResponse` is returned, and the AiToEarn universal response package is not used; the image link is the original return from the upstream and is not transferred. Authentication uses `Authorization: Bearer <API Key>` (OpenAI SDK carries it by default). Existing OpenAI SDK or ecological tools only need to replace the baseURL and API Key to access, and billing is based on AiToEarn points.

The model value comes from `data[n].name` returned by the ["Image Generation Model"](/en/api-reference/get-api-ai-models-image-generation) interface. If you need the AiToEarn universal response format (`code === 0`) and the stable image link after dumping, please use the ["Generate Image"](/en/api-reference/post-api-ai-image-generate) interface instead.



## OpenAPI

````yaml /openapi/en/aitoearn.openapi.json post /api/ai/images/generations
openapi: 3.0.1
info:
  title: AiToEarn Open Platform API
  description: >-
    AiToEarn Open Platform API. You can switch between the China and
    international sites for testing. Business success is determined by whether
    the response body has code === 0.
  version: 1.0.0
  contact: {}
servers:
  - url: https://aitoearn.cn
    description: China site
  - url: https://aitoearn.ai
    description: International site
security: []
tags:
  - name: AI Services
  - name: AI Services/Video Generation
  - name: AI Services/Image Generation
  - name: Channel Management
  - name: Channel Management/Accounts
  - name: Channel Management/Publishing
  - name: Channel Management/Platforms
  - name: Channel Management/Works
  - name: Channel Management/Account Groups
  - name: Channel Management/Authorization
  - name: Asset Management
  - name: AI Services/Large Language Models
paths:
  /api/ai/images/generations:
    post:
      tags:
        - AI Services/Image Generation
      summary: OpenAI Image Generation
      description: >-
        Interface description: Compatible endpoint (Vensen diagram) of OpenAI
        Images API `/v1/images/generations`. The request, response and error
        formats fully comply with the OpenAI specification: OpenAI original
        `ImagesResponse` is returned, and the AiToEarn universal response
        package is not used; the image link is the original return from the
        upstream and is not transferred. Authentication uses `Authorization:
        Bearer <API Key>` (OpenAI SDK carries it by default). Existing OpenAI
        SDK or ecological tools only need to replace the baseURL and API Key to
        access, and billing is based on AiToEarn points.


        The model value comes from `data[n].name` returned by the ["Image
        Generation Model"](/en/api-reference/get-api-ai-models-image-generation)
        interface. If you need the AiToEarn universal response format (`code ===
        0`) and the stable image link after dumping, please use the ["Generate
        Image"](/en/api-reference/post-api-ai-image-generate) interface instead.
      operationId: RelayController_imagesGenerations
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RelayImageGenerationDto'
            examples: {}
        required: true
      responses:
        '200':
          description: >-
            Native third-party protocol response or SSE data, not wrapped in the
            AiToEarn common response envelope.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                description: >-
                  Native third-party protocol response, not wrapped in the
                  AiToEarn common response envelope.
              examples:
                success:
                  summary: Native third-party success response
                  value:
                    id: RelayController_imagesGenerations_example
                    object: response
            text/event-stream:
              schema:
                type: string
                description: SSE streaming response.
      deprecated: false
      security:
        - apikey-header-Authorization: []
components:
  schemas:
    RelayImageGenerationDto:
      type: object
      properties:
        prompt:
          type: string
          description: prompt word
        model:
          type: string
          description: >-
            Image generation model name. First call the ["Image Generation
            Model"](/en/api-reference/get-api-ai-models-image-generation)
            interface (`GET /api/ai/models/image/generation`) and pass in the
            `data[n].name` returned by it; the size, quality, style and price
            supported by each model shall be subject to the return of this
            interface.
        'n':
          type: integer
          minimum: 1
          maximum: 9007199254740991
          description: Generate quantity
        quality:
          type: string
          description: >-
            Image quality. The optional values ​​vary from model to model, and
            are subject to the `data[n].qualities` returned by the ["Image
            Generation
            Model"](/en/api-reference/get-api-ai-models-image-generation)
            interface.
        response_format:
          type: string
          enum:
            - url
            - b64_json
          description: Return format
        size:
          type: string
          description: >-
            Image size. The optional values ​​vary with the model, and are
            subject to the `data[n].sizes` returned by the ["Image Generation
            Model"](/en/api-reference/get-api-ai-models-image-generation)
            interface; the prices for different sizes are different, see
            `data[n].pricing`.
        style:
          type: string
          description: >-
            Image style. The optional values ​​vary with the model, and are
            subject to the `data[n].styles` returned by the ["Image Generation
            Model"](/en/api-reference/get-api-ai-models-image-generation)
            interface; returning empty means that the model does not support
            style parameters.
      required:
        - prompt
        - model
      additionalProperties: true
  securitySchemes:
    apikey-header-Authorization:
      type: apiKey
      in: header
      name: Authorization
      description: 'Used by OpenAI-compatible endpoints. Example: Bearer <token>.'

````