Generate Image Live
callback_url is supplied.
Image Generation
Generate Image
Generate images from text prompts.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Generate images from text prompts.
POST /v1/images/generations
callback_url is supplied.
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Yes | Text prompt describing the image. 1-2,000 characters after trimming; cannot be empty. |
model | string | Yes | Image model to use. The API defaults to model-dev if omitted, but integrations should send this explicitly. See Image Models. |
image_width | integer | No | Width in pixels. Schema accepts 256-2,048. Some providers clamp or map dimensions internally. Default: 1024. |
image_height | integer | No | Height in pixels. Schema accepts 256-2,048. Some providers clamp or map dimensions internally. Default: 1024. |
callback_url | string | No | Webhook URL for async delivery. |
resolution | string | No | Top-level convenience param for variable-size models. Also passed to provider settings. |
quality | string | No | Top-level convenience param for quality-priced models. Also passed to provider settings. |
additional_settings | object | No | Model-specific settings such as seed, aspect_ratio, negative_prompt, num_inference_steps, guidance_scale, output_format, enable_web_search, and enable_image_search. |
enable_fallback | boolean | No | Defaults to true. Image generation models currently have no fallback configured. |
curl --request POST "https://api.uncensored.com/api/v1/images/generations" \
--header "x-api-key: YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"prompt": "A beautiful sunset over mountains, photorealistic, 8k",
"model": "model-pro",
"image_width": 1024,
"image_height": 1024
}'
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "completed",
"url": "https://media.lesscensored.com/images/550e8400.jpg",
"generation_time": 2.5,
"model": "model-pro"
}
{
"prompt": "A cyberpunk cityscape at night",
"model": "model-pro",
"image_width": 1024,
"image_height": 1024,
"callback_url": "https://your-server.com/webhook"
}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "processing",
"status_url": "https://api.uncensored.com/api/v1/images/generation/jobs/550e8400-e29b-41d4-a716-446655440000",
"webhook_url": "https://your-server.com/webhook",
"created_at": "2026-05-09T10:30:00Z"
}
GET /v1/images/generation/jobs/{job_id}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "completed",
"image_url": "https://media.lesscensored.com/images/550e8400.jpg",
"model": "model-pro",
"created_at": "2026-05-09T10:30:00Z",
"completed_at": "2026-05-09T10:30:05Z",
"generation_time": 2.5
}
| Status code | Description |
|---|---|
200 | Image generated successfully in sync mode. |
202 | Job accepted and queued for async mode. |
400 | Invalid request parameters. |
402 | Insufficient funds. |
403 | Content moderation failed, or scope does not permit this model. |
429 | Rate limit exceeded. |
500 | Internal server error. |