Input Schema
{
"bodyFields": {
"aspect_ratio": {
"default": "1:1",
"description": "The aspect ratio of the generated image.",
"enum": [
"21:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16"
],
"required": false,
"type": "\"21:9\" | \"16:9\" | \"3:2\" | \"4:3\" | \"5:4\" | \"1:1\" | \"4:5\" | \"3:4\" | \"2:3\" | \"9:16\""
},
"num_images": {
"default": 1,
"description": "The number of images to generate.",
"enum": [
"1"
],
"required": false,
"type": "integer"
},
"output_format": {
"default": "png",
"description": "The format of the generated image.",
"enum": [
"jpeg",
"png",
"webp"
],
"required": false,
"type": "\"jpeg\" | \"png\" | \"webp\""
},
"prompt": {
"description": "The text prompt to generate an image from.",
"example": "An action shot of a black lab swimming in an inground suburban swimming pool. The camera is placed meticulously on the water line, dividing the image in half, revealing both the dogs head above water holding a tennis ball in it's mouth, and it's paws paddling underwater.",
"maximum": 50000,
"minimum": 3,
"required": true,
"type": "string"
},
"resolution": {
"default": "1K",
"description": "The resolution of the image to generate.",
"enum": [
"1K",
"2K",
"4K"
],
"required": false,
"type": "\"1K\" | \"2K\" | \"4K\""
},
"sync_mode": {
"default": false,
"description": "If `True`, the media will be returned as a data URI and the output data won't be available in the request history.",
"required": false,
"type": "boolean"
}
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Output Schema
{
"jobId": {
"description": "Unique job identifier",
"type": "string"
},
"message": {
"description": "Human-readable message with status tracking URL",
"type": "string"
},
"statusCode": {
"description": "HTTP status code",
"type": "integer"
},
"statusUrl": {
"description": "URL to check job status",
"type": "string"
},
"timestamp": {
"description": "ISO 8601 timestamp of the response",
"type": "string"
}
}