Generations（Image generation）

POST

/v1/images/generations

Official API Documentation

Create image based on text prompt

Price：
Text input :5 PTC/1M
Image output: 40 PTC/1M

Request

Query Params

response_format

string

optional

url

Example:

url

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

prompt

string

required

Text description of the required image. Maximum length is 1000 characters.

size

string

optional

Size of the generated image. Must be one of 1024x1024, 1536x1024 (landscape), 1024x1536 (portrait).

background

string

optional

transparent, opaque or auto

moderation

string

optional

low or auto

string

optional

1-10

quality

string

optional

auto, high, medium and low

Example

{
    "prompt": "A cute baby sea otter",
    "model": "gpt-image-1",
    "size": "1024x1024"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/v1/images/generations?response_format=url' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A cute baby sea otter",
    "model": "gpt-image-1",
    "size": "1024x1024"
}'

Responses

🟢200Create image

application/json

Body

created

integer

required

data

array [object {1}]

required

url

string

required

Example

{
    "data": [
        {
            "url": "",
            "b64_json": ""
        }
    ],
    "created": 1745694920,
    "usage": {
        "prompt_tokens": 0,
        "completion_tokens": 0,
        "total_tokens": 4172,
        "prompt_tokens_details": {
            "cached_tokens_details": {}
        },
        "completion_tokens_details": {},
        "input_tokens": 12,
        "output_tokens": 4160,
        "input_tokens_details": {
            "text_tokens": 12,
            "cached_tokens_details": {}
        }
    }
}

Modified at 2025-05-15 07:17:32

Generate images

Edits（Modify Image）