curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "flux-kontext-pro",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A luxury perfume bottle on a reflective marble surface, premium studio lighting",
"size": "16:9",
"output_format": "png"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2025-11-12T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 401,
"error": {
"message": "Unauthorized - Invalid API key",
"type": "authentication_error"
}
}Flux
Flux Kontext Image Generation
Image generation and image editing models powered by Black Forest Labs Flux Kontext
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "flux-kontext-pro",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A luxury perfume bottle on a reflective marble surface, premium studio lighting",
"size": "16:9",
"output_format": "png"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2025-11-12T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 401,
"error": {
"message": "Unauthorized - Invalid API key",
"type": "authentication_error"
}
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the response result through the unified Query Task Status endpoint.
Flux Kontext Image Generation
Flux Kontext is powered by Black Forest Labs. It supports both text-to-image generation and image editing through the same unified submit endpoint.Available Models
- flux-kontext-pro - Flux Kontext Pro text-to-image generation
- flux-kontext-pro-edit - Flux Kontext Pro image editing,
image_urlsis required - flux-kontext-max - Flux Kontext Max text-to-image generation
- flux-kontext-max-edit - Flux Kontext Max image editing,
image_urlsis required
Notes
sizesupports1:1,4:3,3:4,16:9,9:16,21:9,9:21output_formatsupportspng,jpgimage_urlsis required for edit models- Only
image_urls[0]is used as the input image - Other downstream fields are not exposed in the current API and use system defaults
- Credits are charged directly according to the configured model price
Authorizations
All API endpoints require Bearer Token authentication
Get your API Key:
Visit the API Key Management Page to get your API Key
Add it to the request header:
Authorization: Bearer YOUR_API_KEY
Body
application/json
Flux Kontext model identifier
Available options:
flux-kontext-pro, flux-kontext-pro-edit, flux-kontext-max, flux-kontext-max-edit Input parameters for generation
Show child attributes
Show child attributes
Webhook callback URL for result notifications
Example:
"https://your-domain.com/callback"