Image Edit(OpenAI Format) - 302.AI API Document

Request

Query Params

webhook

string

optional

Callback URL

Header Params

Authorization

string

required

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

model

string

Model

required

prompt

string

Prompt

required

image

string

Image

required

mask

string

Mask Image

optional

background

string

Background

optional

Default:

auto

moderation

string

Content Moderation

optional

n

integer

Number of Generated Images

optional

Default:

1

output_compression

integer

Output Compression

optional

Default:

100

output_format

enum<string>

Image Format

optional

Allowed values:

pngjpegwebp

quality

string

Generation Quality

optional

response_format

enum<string>

Response Format

optional

Allowed values:

urlbs64_jsonany other value

size

string

Image Size

optional

style

string

Style

optional

user

string

User Identifier

optional

For more additional fields of non-OpenAI provider models, please refer to the documentation

string

optional

Examples

json请求示例示例 2

{
  "prompt": "",
  "model": "302-translate-image",
  "response_format": "url",
  "image": "https://file.302ai.cn/gpt/imgs/20250723/compressed_3f6391df48f74e9dbe60999b88772d87.jpeg",
  "tgtLang": "zh"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

cURL

json请求示例示例 2

curl --location --request POST 'https://api.302.ai/302/images/edits?webhook' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "",
  "model": "302-translate-image",
  "response_format": "url",
  "image": "https://file.302ai.cn/gpt/imgs/20250723/compressed_3f6391df48f74e9dbe60999b88772d87.jpeg",
  "tgtLang": "zh"
}'

Responses

🟢200成功

application/json

Body

created

integer

生成的时间戳

required

data

array [object {2}]

required

url

string

optional

bs62_json

string

optional

usage

object

token详情

required

Except for the gpt-image-1 model, models from other vendors are charged per request, so the token value is always 0.

total_tokens

integer

required

input_tokens

integer

required

output_tokens

integer

required

input_tokens_details

object

required

Example

{
    "created": 0,
    "data": [
        {
            "url": "string",
            "bs62_json": "string"
        }
    ],
    "usage": {
        "total_tokens": 0,
        "input_tokens": 0,
        "output_tokens": 0,
        "input_tokens_details": {
            "text_tokens": 0,
            "image_tokens": 0
        }
    }
}