Image Generation

Generate high-quality images using our AI models.

​

Endpoint Details

​

Request Format

​

Headers

​

Body Parameters

​

Example Request

{
  "prompt": "Your image description",
  "model": "black-forest-labs/FLUX.1-schnell",
  "options": {
    "steps": 4
  }
}

​

Response Format

{
  "url": "/api/images/filename.jpg",
  "data": [
    {
      "url": "/api/images/filename.jpg",
      "index": 0
    }
  ],
  "model": "black-forest-labs/FLUX.1-schnell",
  "timings": {}
}

​

Image Serving

​

Endpoint

• No authentication required
• Returns the image file directly
• Images are available immediately after generation

​

Caching

• Generated images are cached for 1 hour
• Cache key is based on prompt, model, and options
• Images are stored locally and served via public endpoint

​

Error Scenarios

• 400: Missing or invalid prompt
• 401: Missing API key
• 403: Invalid API key
• 404: Image not found (for serving endpoint)
• 429: Rate limit exceeded
• 500: Internal server error

​

Error Response Example

{
  "error": {
    "message": "Error description",
    "code": 400
  }
}

In development mode, you’ll receive additional error details:

{
  "error": {
    "message": "Error description",
    "code": 400,
    "detail": "Detailed error message",
    "stack": "Error stack trace"
  }
}