curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "grok-imagine-image-2.0",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic product photo of a glass perfume bottle on black stone, dramatic rim lighting",
"n": 1,
"aspect_ratio": "16:9",
"resolution": "2K",
"quality": "medium"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1786751400-abcd1234",
"status": "not_started",
"created_time": "2026-08-15T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Grok (xAI)
Grok Imagine Image 2.0
The Grok Imagine Image 2.0 API generates images from text or edits one to three reference images. Quality and resolution are selectable, and one request can return up to four images.
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": "grok-imagine-image-2.0",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic product photo of a glass perfume bottle on black stone, dramatic rim lighting",
"n": 1,
"aspect_ratio": "16:9",
"resolution": "2K",
"quality": "medium"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1786751400-abcd1234",
"status": "not_started",
"created_time": "2026-08-15T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_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 result through the unified Query Task Status endpoint.
grok-imagine-image-2.0 for text-to-image generation and image editing through one model ID.
When input.image_urls is empty or omitted, the model creates images from the prompt. When input.image_urls contains one to three images, the model edits those images. The default aspect ratio is 1:1.
Use input.quality and input.resolution to control the output tier, and input.n to request up to four output images. Usage depends on the selected output count, quality, resolution, and number of input images.
Models
- grok-imagine-image-2.0 - Text-to-image generation and multi-image editing
Authorizations
All API endpoints require Bearer Token authentication.
Create an API key: sign in to PoYo, open Dashboard → API Key at poyo.ai/dashboard/api-key, and click to create a key.
Add it to the request header:
Authorization: Bearer YOUR_API_KEY
Body
application/json
Response
Task submitted successfully
Business status code. 200 means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with code: 400 in the body.
200: Success400: Invalid request parameters401: Missing or invalid API key402: Insufficient credits403: Permission denied404: Resource not found408: Request timeout429: Rate limit exceeded500: Internal server error502: Upstream service error503: Service unavailable
See Error Codes for details.
Available options:
200, 400, 401, 402, 403, 404, 408, 429, 500, 502, 503 Example:
200