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

# Openai Images Generations



## OpenAPI

````yaml /openapi/openai.json post /openai/images/generations
openapi: 3.0.0
info:
  title: OpenAI generation
  version: 1.0.0
  description: API reference for OpenAI generation on Ace Data Cloud.
servers:
  - url: https://api.acedata.cloud
    description: Ace Data Cloud API
security:
  - bearerAuth: []
paths:
  /openai/images/generations:
    post:
      summary: Openai Images Generations
      parameters:
        - in: header
          name: accept
          schema:
            enum:
              - application/json
            type: string
          required: false
          description: Openai Images Generations Param Accept
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - prompt
                - model
              properties:
                prompt:
                  type: string
                  example: A cute baby sea otter
                  enum:
                    - A cute baby sea otter
                    - >-
                      A wooden bookshelf consisting of three shelves: on the top
                      shelf one book, the second shelf three books, and the
                      bottom shelf seven books.
                    - >-
                      Cinematic minimal portrait of a solitary man standing in
                      an intense orange-to-red gradient environment, strong
                      silhouette lighting, deep shadow contrast, reflective
                      glossy floor, symmetrical composition.
                    - >-
                      Symmetrical design featuring two elegant blue peacocks
                      with detailed feather patterns, surrounded by blue floral
                      elements, intricate vintage botanical ornament, soft beige
                      background, decorative art illustration.
                    - >-
                      Avant-garde sports fashion advertisement, oversized
                      basketball posed like a monumental sculpture, female
                      athlete reclining across the ball's curved surface, giant
                      word 'ELEVATE' in bold typography behind, burnt orange
                      studio backdrop, glossy reflective floor.
                    - >-
                      High-fashion surrealist poster for Rolex. Deep emerald
                      green minimalist studio with polished reflective floor. A
                      massive Rolex watch standing upright like a monument; a
                      male model in tailored dark green suit leans casually
                      against the watch face, wearing a matching Rolex.
                    - >-
                      Ultra-realistic product photography of a rich strawberry
                      soft-serve ice cream in a crispy waffle cone, clean modern
                      premium aesthetic, soft serve vibrant natural pink,
                      sculpted swirl with curled peak, lightly topped with
                      strawberry dust.
                    - >-
                      Hyper-realistic UI/UX mockup on a slim modern laptop on a
                      minimal wooden desk with soft natural daylight; clean SaaS
                      dashboard with elegant typography, glassmorphism cards,
                      smooth gradients, subtle drop shadows, charts, sidebar
                      navigation, macOS-style window frame.
                    - >-
                      9:16 vertical Korean idol portrait photoshoot, 3x3 grid
                      (nine frames), same person in all images, consistent
                      facial features and styling, soft black mist filter
                      effect, lowered contrast, blooming highlights, subtle glow
                      around light sources.
                    - >-
                      Mobile phone photo, old CCD camera aesthetic, harsh flash,
                      grainy, dim messy indoor lighting, candid snapshot
                      feeling, slight motion blur.
                    - Create a science fiction movie poster.
                    - 以中国连环画（小人书）的风格帮我绘制大闹天宫
                    - 新中式水墨山水海报，竖版9:16构图，东方极简美学风格，大面积留白，主题是春岚一叶红
                  description: Openai Images Generations Prompt
                background:
                  enum:
                    - transparent
                    - opaque
                    - auto
                  type: string
                  default: auto
                  description: Openai Images Generations Background
                model:
                  enum:
                    - dall-e-2
                    - dall-e-3
                    - gpt-image-1
                    - gpt-image-1.5
                    - gpt-image-2
                    - gpt-image-2:reverse
                    - gpt-image-2:official
                    - nano-banana
                    - nano-banana-2
                    - nano-banana-pro
                  type: string
                  description: Openai Images Generations Model
                moderation:
                  enum:
                    - low
                    - auto
                  type: string
                  default: auto
                  description: Openai Images Generations Moderation
                'n':
                  type: integer
                  minimum: 1
                  maximum: 10
                  default: 1
                  example: 1
                  description: Openai Images Generations N
                output_compression:
                  type: integer
                  minimum: 0
                  maximum: 100
                  default: 100
                  description: Openai Images Generations Output Compression
                output_format:
                  enum:
                    - png
                    - jpeg
                    - webp
                  type: string
                  default: png
                  description: Openai Images Generations Output Format
                partial_images:
                  type: integer
                  minimum: 0
                  maximum: 3
                  default: 0
                  description: Openai Images Generations Partial Images
                size:
                  type: string
                  default: auto
                  example: 1024x1024
                  nullable: true
                  pattern: ^(auto|\d+x\d+)$
                  description: Openai Images Generations Size
                quality:
                  enum:
                    - auto
                    - high
                    - medium
                    - low
                    - hd
                    - standard
                  type: string
                  default: auto
                  example: auto
                  description: Openai Images Generations Quality
                response_format:
                  enum:
                    - url
                    - b64_json
                  type: string
                  default: url
                  example: url
                  nullable: true
                  description: Openai Images Generations Response Format
                style:
                  enum:
                    - vivid
                    - natural
                  type: string
                  default: vivid
                  example: vivid
                  description: Openai Images Generations Style
                callback_url:
                  type: string
                  description: Openai Images Generations Callback Url
                async:
                  type: boolean
                  description: Openai Images Generations Async
            example:
              prompt: A cute baby sea otter
              model: dall-e-2
              'n': 1
              size: 1024x1024
              quality: auto
              response_format: url
              style: vivid
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                required:
                  - created
                  - data
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          description: Openai Images Generations Response 200 Data Url
                        b64_json:
                          type: string
                          description: Openai Images Generations Response 200 Data B64 Json
                        revised_prompt:
                          type: string
                          description: >-
                            Openai Images Generations Response 200 Data Revised
                            Prompt
                      description: Openai Images Generations Response 200 Data
                  created:
                    type: number
          description: Openai Images Generations Response 200
        '400':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: token_mismatched
                        message: The specified token is not matched with API.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: token_mismatched
                            description: Openai Images Generations Response 400 Error Code
                          message:
                            type: string
                            example: The specified token is not matched with API.
                            description: >-
                              Openai Images Generations Response 400 Error
                              Message
                      trace_id:
                        type: string
                        description: Openai Images Generations Response 400 Trace Id
                  - type: object
                    example:
                      error:
                        code: api_not_implemented
                        message: The API is not implemented.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: api_not_implemented
                            description: >-
                              Openai Images Generations Response 400 Error Code
                              2
                          message:
                            type: string
                            example: The API is not implemented.
                            description: >-
                              Openai Images Generations Response 400 Error
                              Message 2
                      trace_id:
                        type: string
                        description: Openai Images Generations Response 400 Trace Id 2
          description: Openai Images Generations Response 400
        '401':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: invalid_token
                        message: The specified token is invalid or wrong.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: invalid_token
                            description: Openai Images Generations Response 401 Error Code
                          message:
                            type: string
                            example: The specified token is invalid or wrong.
                            description: >-
                              Openai Images Generations Response 401 Error
                              Message
                      trace_id:
                        type: string
                        description: Openai Images Generations Response 401 Trace Id
          description: Openai Images Generations Response 401
        '403':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: forbidden
                        message: >-
                          Sorry! Our Al moderators feel your prompt might be
                          against our community standards.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: forbidden
                            description: Openai Images Generations Response 403 Error Code
                          message:
                            type: string
                            example: >-
                              Sorry! Our Al moderators feel your prompt might be
                              against our community standards.
                            description: >-
                              Openai Images Generations Response 403 Error
                              Message
                      trace_id:
                        type: string
                        description: Openai Images Generations Response 403 Trace Id
          description: Openai Images Generations Response 403
        '429':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: too_many_requests
                        message: You have exceeded the rate limit.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: too_many_requests
                            description: Openai Images Generations Response 429 Error Code
                          message:
                            type: string
                            example: You have exceeded the rate limit.
                            description: >-
                              Openai Images Generations Response 429 Error
                              Message
                      trace_id:
                        type: string
                        description: Openai Images Generations Response 429 Trace Id
          description: Openai Images Generations Response 429
        '500':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: api_error
                        message: Internal server error.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: api_error
                            description: Openai Images Generations Response 500 Error Code
                          message:
                            type: string
                            example: Internal server error.
                            description: >-
                              Openai Images Generations Response 500 Error
                              Message
                      trace_id:
                        type: string
                        description: Openai Images Generations Response 500 Trace Id
          description: Openai Images Generations Response 500
        '504':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: timeout
                        message: Timeout to generate the image.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: timeout
                            description: Openai Images Generations Response 504 Error Code
                          message:
                            type: string
                            example: Timeout to generate the image.
                            description: >-
                              Openai Images Generations Response 504 Error
                              Message
                      trace_id:
                        type: string
                        description: Openai Images Generations Response 504 Trace Id
          description: Openai Images Generations Response 504
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API token from https://platform.acedata.cloud

````