Image AI API - Image Generation

The Image AI API allows you to generate high-quality images from text descriptions using state-of-the-art AI models. This documentation covers the generate-image endpoint, which is the core functionality of our service.

curl -X POST https://imageaiapi.com/api/generate-image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "prompt": "A serene mountain lake at sunset",
    "style": "photorealistic",
    "width": 1024,
    "height": 1024
  }'

Authentication

All API requests require authentication using an API key. You can obtain your API key by signing up for an account on the Image AI API website.

Include your API key in all requests by adding an Authorization header with the value Bearer YOUR_API_KEY.

# Example of proper authentication
curl -X POST https://imageaiapi.com/api/generate-image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "prompt": "A serene mountain lake at sunset" }'

Rate Limits

Rate limits vary based on your subscription plan. The headers in the API response include information about your current rate limit status.

When you exceed your rate limit, the API will return a 429 Too Many Requests status code.

Generate Image Endpoint

The generate-image endpoint creates an image based on your text prompt and additional parameters.

Headers

Request Body

The request body should be a JSON object with the following parameters:

Example Request Body

{
  "prompt": "A serene mountain lake at sunset, with pink and orange clouds reflected in the still water, surrounded by pine trees and snow-capped peaks",
  "style": "photorealistic",
  "width": 1024,
  "height": 1024,
  "seed": 42,
  "guidance_scale": 7.5,
  "negative_prompt": "blurry, distorted, low quality"
}

Response Object

A successful API call returns a JSON object with information about the generated image:

Example Response

{
  "id": "img_7a9b2c3d",
  "url": "https://cdn.imageaiapi.com/img_7a9b2c3d.png",
  "width": 1024,
  "height": 1024,
  "created_at": "2025-04-21T15:23:48Z",
  "prompt": "A serene mountain lake at sunset",
  "seed": 42
}

Error Handling

The API uses standard HTTP status codes to indicate the success or failure of a request. In case of an error, the response will include a JSON object with more details.

Example Error Response

{
  "error": {
    "message": "Invalid parameter: width must be one of 512, 768, 1024, 1536, or 1920",
    "type": "invalid_parameter",
    "param": "width",
    "code": "parameter_invalid"
  }
}

Frequently Asked Questions

Find answers to common questions about using the Image AI API:

{
  "prompt": "A serene mountain lake at sunset",
  "style": "photorealistic",
  "n": 4,  // Generate 4 variations
  "width": 1024,
  "height": 1024
}

Support

We're here to help you make the most of the Image AI API. If you have any questions or need assistance, here's how to reach us: