Skip to content

Generate 3.0 (Image Reframe) Reframe

POST https://www.kkiai.com/ideogram/v1/ideogram-v3/reframe

Use the Ideogram 3.0 model to synchronously generate images based on a given prompt and optional parameters.
For specific parameters, see the official documentation: https://developer.ideogram.ai/api-reference/api-reference/reframe-v3
The returned image URLs are valid for 24 hours. Images cannot be accessed after this time.
Images have been reverse-proxied.

Request Parameters

Header Parameters

ParameterTypeRequiredDescriptionExample
AcceptstringRequiredapplication/json
AuthorizationstringRequiredBearer {{YOUR_API_KEY}}

Body Parameters (multipart/form-data)

ParameterTypeRequiredDescription
imagefileRequiredImage being reframed (maximum size 10 MB); currently supports JPEG, WebP, and PNG formats only.
resolutionstringOptional

cURL Example

bash
curl --location --request POST 'https://www.kkiai.com/ideogram/v1/ideogram-v3/reframe' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--form 'image=@"C:\\Users\\Administrator\\Desktop\\example.png"' \
--form 'resolution="512x1536"'

Response

🟢 200 Success

Response Body

ParameterTypeRequiredDescription
codeintegerRequired
messagestringRequired
request_idstringRequired
dataobjectRequired
  └ task_idstringRequired
  └ task_statusstringRequired
  └ created_atintegerRequired
  └ updated_atintegerRequired

Response Example

json
{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "CjMT7WdSwWcAAAAAALvB3g",
    "data": {
        "task_id": "CjMT7WdSwWcAAAAAALvB3g",
        "task_status": "submitted",
        "created_at": 1733851336696,
        "updated_at": 1733851336696
    }
}