OpenAI image edit (legacy alias)

POST

/v1/edits

OpenAI

Legacy alias for /v1/images/edits. Accepts the same multipart/form-data parameters and returns the same response shape.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params multipart/form-dataRequired

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/edits' \
--header 'Authorization: Bearer <token>' \
--form 'model=""' \
--form 'prompt=""' \
--form 'image=@""' \
--form 'mask=@""' \
--form 'n="1"' \
--form 'size=""' \
--form 'quality=""' \
--form 'response_format=""' \
--form 'background=""' \
--form 'output_format=""' \
--form 'output_compression=""' \
--form 'user=""'

Responses

🟢200

application/json

Successful response

Bodyapplication/json

Example

{
    "created": 0,
    "data": [
        {
            "url": "string",
            "b64_json": "string",
            "revised_prompt": "string"
        }
    ]
}

🟠400

🟠401

🟠429

🔴500

Modified at 2026-07-29 01:22:52

OpenAI image edit

Claude message