POST /v1/images/generations

Method: POSTEndpoint: /v1/images/generations

This section contains endpoint-specific behavior, parameters, or usage notes for this API.

Request Parameters

Header Parameters

Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters application/json

model
string
Required
prompt
string
Required
size
string
Optional
This is ultimately converted into a ratio, so using aspect_ratio directly is recommended.
aspect_ratio
string
Optional
21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21
image
array
[string]
  // provider-specific example normalized for English documentation
Optional
Example
{
"model"
:
"string"
,
"prompt"
:
"string"
,
"size"
:
"string"
,
"aspect_ratio"
:
"string"
,
"image"
:
[
"string"
]
}

Example Request

Shell

curl --location --request POST '/v1/images/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "string",
    "prompt": "string",
    "size": "string",
    "aspect_ratio": "string",
    "image": [
        "string"
    ]
}'

Response

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{}