> ## 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
      operationId: createOpenaiImagesEdits
      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.5-flare
                    - gpt-image-2.5-flare:official
                    - gpt-image-2.5-sunburst
                    - gpt-image-2.5-sunburst:official
                    - 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
                  nullable: true
                  pattern: ^(auto|\d+x\d+)$
                  description: Openai Images Edits Size
                  default: auto
                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
                  example: mask.png
                model:
                  enum:
                    - dall-e-2
                    - dall-e-3
                    - gpt-image-1
                    - gpt-image-1.5
                    - gpt-image-2
                    - gpt-image-2.5-flare
                    - gpt-image-2.5-flare:official
                    - gpt-image-2.5-sunburst
                    - gpt-image-2.5-sunburst:official
                    - 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 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
                  example: 1024x1024
                  nullable: true
                  pattern: ^(auto|\d+x\d+)$
                  description: Openai Images Edits Multipart Form Data Size
                  default: auto
                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:
                oneOf:
                  - 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
                  - type: object
                    required:
                      - task_id
                    properties:
                      task_id:
                        type: string
                        description: Openai Images Edits Response 200 Task Id
              example:
                data: []
                created: 0
          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

````