Skip to content
Last updated

Generate images from text prompts using AI models.

POSThttps://api.aitronos.com/v1/images/generate

Request Body (JSON)

provider string required

Provider to use. Values: openai, clipdrop.

organization_id string required

Organization ID (org_ prefixed string).

prompt string required

Text prompt for image generation (max 1000 characters for Clipdrop).

size string optional

Size for OpenAI. Values: 1024x1024, 1024x1536, 1536x1024.

Returns

Returns raw image bytes (PNG format) with provider metadata in response headers.

Response Headers

  • X-Provider - Provider that processed the request
  • X-Provider-Request-Id - Provider's request ID (if available)
  • X-Provider-Credits-Consumed - Credits consumed (Clipdrop only)
Bash
curl -X POST "https://api.aitronos.com/v1/images/generate" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "openai",
    "organization_id": "org_abc123",
    "prompt": "A serene mountain landscape at sunset with a crystal clear lake",
    "size": "1024x1024"
  }' \
  --output generated_image.png

Response:

Returns raw image bytes (PNG format).

Response Headers:

Content-Type: image/png
X-Provider: openai
X-Provider-Request-Id: req_abc123