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



## OpenAPI

````yaml /openapi/openai.json post /openai/images/edits
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/edits:
    post:
      summary: Openai Images Edits
      parameters:
        - in: header
          name: accept
          schema:
            enum:
              - application/json
            type: string
          required: false
          description: Openai Images Edits Param Accept
        - in: header
          name: Content-Type
          schema:
            enum:
              - multipart/form-data
              - application/json
            type: string
          required: true
          description: Openai Images Edits Param Content Type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - image
                - prompt
              properties:
                image:
                  oneOf:
                    - type: string
                      format: uri
                    - type: array
                      items:
                        type: string
                        format: uri
                      maxItems: 16
                  example: >-
                    https://platform.cdn.acedata.cloud/gpt-image/cb104e35-af1f-45be-9fac-b62e2b256753_0.png
                  description: Openai Images Edits Image
                prompt:
                  type: string
                  example: Turn this photo into a Studio Ghibli style painting.
                  description: Openai Images Edits Prompt
                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-lite
                    - nano-banana-2
                    - nano-banana-pro
                  type: string
                  default: dall-e-3
                  description: Openai Images Edits Model
                'n':
                  type: integer
                  default: 1
                  minimum: 1
                  maximum: 10
                  description: Openai Images Edits N
                background:
                  enum:
                    - transparent
                    - opaque
                    - auto
                  type: string
                  default: auto
                  description: Openai Images Edits Background
                input_fidelity:
                  enum:
                    - high
                    - low
                  type: string
                  description: Openai Images Edits Input Fidelity
                output_format:
                  enum:
                    - png
                    - jpeg
                    - webp
                  type: string
                  default: png
                  description: Openai Images Edits Output Format
                output_compression:
                  type: integer
                  minimum: 0
                  maximum: 100
                  default: 100
                  description: Openai Images Edits Output Compression
                quality:
                  enum:
                    - auto
                    - high
                    - medium
                    - low
                    - standard
                  type: string
                  default: auto
                  description: Openai Images Edits Quality
                size:
                  type: string
                  default: 1024x1024
                  nullable: true
                  pattern: ^(auto|\d+x\d+)$
                  description: Openai Images Edits Size
                response_format:
                  enum:
                    - url
                    - b64_json
                  type: string
                  default: url
                  nullable: true
                  description: Openai Images Edits Response Format
                callback_url:
                  type: string
                  description: Openai Images Edits Callback Url
                async:
                  type: boolean
                  description: Openai Images Edits Async
          multipart/form-data:
            schema:
              type: object
              required:
                - image
                - prompt
              properties:
                image:
                  type: array
                  items:
                    type: string
                    format: binary
                  maxItems: 16
                  description: Openai Images Edits Multipart Form Data Image
                prompt:
                  type: string
                  description: Openai Images Edits Multipart Form Data Prompt
                background:
                  enum:
                    - transparent
                    - opaque
                    - auto
                  type: string
                  default: auto
                  description: Openai Images Edits Multipart Form Data Background
                input_fidelity:
                  enum:
                    - high
                    - low
                  type: string
                  description: Openai Images Edits Multipart Form Data Input Fidelity
                mask:
                  type: string
                  format: binary
                  description: Openai Images Edits Multipart Form Data Mask
                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
                  default: dall-e-3
                  description: Openai Images Edits Multipart Form Data Model
                'n':
                  type: integer
                  default: 1
                  minimum: 1
                  maximum: 10
                  description: Openai Images Edits Multipart Form Data N
                output_compression:
                  type: integer
                  minimum: 0
                  maximum: 100
                  default: 100
                  description: Openai Images Edits Multipart Form Data Output Compression
                output_format:
                  enum:
                    - png
                    - jpeg
                    - webp
                  type: string
                  default: png
                  description: Openai Images Edits Multipart Form Data Output Format
                partial_images:
                  type: integer
                  minimum: 0
                  maximum: 3
                  default: 0
                  description: Openai Images Edits Multipart Form Data Partial Images
                quality:
                  enum:
                    - auto
                    - high
                    - medium
                    - low
                    - standard
                  type: string
                  default: auto
                  description: Openai Images Edits Multipart Form Data Quality
                response_format:
                  enum:
                    - url
                    - b64_json
                  type: string
                  default: url
                  example: url
                  nullable: true
                  description: Openai Images Edits Multipart Form Data Response Format
                size:
                  type: string
                  default: 1024x1024
                  example: 1024x1024
                  nullable: true
                  pattern: ^(auto|\d+x\d+)$
                  description: Openai Images Edits Multipart Form Data Size
                callback_url:
                  type: string
                  description: Openai Images Edits Multipart Form Data Callback Url
                async:
                  type: boolean
                  description: Openai Images Edits Multipart Form Data Async
        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 Edits Response 200 Data Url
                        b64_json:
                          type: string
                          description: Openai Images Edits Response 200 Data B64 Json
                        revised_prompt:
                          type: string
                          description: Openai Images Edits Response 200 Data Revised Prompt
                      description: Openai Images Edits Response 200 Data
                  created:
                    type: number
          description: Openai Images Edits 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 Edits Response 400 Error Code
                          message:
                            type: string
                            example: The specified token is not matched with API.
                            description: Openai Images Edits Response 400 Error Message
                      trace_id:
                        type: string
                        description: Openai Images Edits 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 Edits Response 400 Error Code 2
                          message:
                            type: string
                            example: The API is not implemented.
                            description: Openai Images Edits Response 400 Error Message 2
                      trace_id:
                        type: string
                        description: Openai Images Edits Response 400 Trace Id 2
          description: Openai Images Edits 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 Edits Response 401 Error Code
                          message:
                            type: string
                            example: The specified token is invalid or wrong.
                            description: Openai Images Edits Response 401 Error Message
                      trace_id:
                        type: string
                        description: Openai Images Edits Response 401 Trace Id
          description: Openai Images Edits 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 Edits Response 403 Error Code
                          message:
                            type: string
                            example: >-
                              Sorry! Our Al moderators feel your prompt might be
                              against our community standards.
                            description: Openai Images Edits Response 403 Error Message
                      trace_id:
                        type: string
                        description: Openai Images Edits Response 403 Trace Id
          description: Openai Images Edits 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 Edits Response 429 Error Code
                          message:
                            type: string
                            example: You have exceeded the rate limit.
                            description: Openai Images Edits Response 429 Error Message
                      trace_id:
                        type: string
                        description: Openai Images Edits Response 429 Trace Id
          description: Openai Images Edits 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 Edits Response 500 Error Code
                          message:
                            type: string
                            example: Internal server error.
                            description: Openai Images Edits Response 500 Error Message
                      trace_id:
                        type: string
                        description: Openai Images Edits Response 500 Trace Id
          description: Openai Images Edits 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 Edits Response 504 Error Code
                          message:
                            type: string
                            example: Timeout to generate the image.
                            description: Openai Images Edits Response 504 Error Message
                      trace_id:
                        type: string
                        description: Openai Images Edits Response 504 Trace Id
          description: Openai Images Edits Response 504
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API token from https://platform.acedata.cloud

````