Guides
Image Creation
Generate, edit, and call creative image models
Use POST /v1/images/generations to generate images and POST /v1/images/edits to edit them. Supported sizes, reference images, quality levels, and output formats differ by model; use the model catalog and request validation as the source of truth.
curl https://api.focalapi.com/v1/images/generations \
-H "Authorization: Bearer $FOCALAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5-0-260128",
"prompt": "A futuristic sneaker poster with glass texture, clean studio lighting, blue and white palette",
"size": "2k",
"watermark": false
}'Parameters
| Parameter | Description |
|---|---|
model | Required. Use an image-model ID returned by GET /v1/models. |
prompt | Describe subject, composition, material, lighting, and style. |
size | Resolution or aspect ratio, depending on the model. |
n | Image count; billed by actual output count. |
quality | Use only when the model supports it. |
Creative models validate parameters according to their native capabilities. See Creative Image Models for current IDs, parameter differences, and native Gemini fields.