REST API Documentation

Analyze images and generate prompts programmatically. Available on the Business plan.

API access requires a Business plan ($29/mo). View pricing

Authentication

Include your API key in the X-API-Key header with every request.

X-API-Key: your_api_key_here
POST /v1/analyze

Analyze an image and return formatted prompts for all 6 AI models.

JSON Request (Base64)
curl -X POST https://promptfrom.com/v1/analyze \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_base64": "BASE64_ENCODED_IMAGE_DATA",
    "mime_type": "image/jpeg"
  }'
Multipart Request (File Upload)
curl -X POST https://promptfrom.com/v1/analyze \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "image=@photo.jpg"
200 Response
{
  "data": {
    "metadata": {
      "subject": "A woman standing in a neon-lit alley",
      "style_tags": ["cyberpunk", "neon", "cinematic"],
      "lighting": "neon pink and blue, dramatic side lighting",
      "composition": "medium shot, shallow depth of field",
      "color_palette": ["#1a1a2e", "#e94560", "#0f3460"],
      "mood": "mysterious, futuristic, moody"
    },
    "prompts": {
      "midjourney": "A woman standing in a neon-lit... --ar 2:3 --v 6.1",
      "dalle3": "A photorealistic portrait of a woman...",
      "stable_diffusion": {
        "positive": "masterpiece, best quality, ...",
        "negative": "low quality, blurry, deformed..."
      },
      "flux": "cyberpunk woman, neon alley, ...",
      "runway": "Scene: A woman stands in a neon-lit...",
      "kling": "cinematic woman in neon alley, ..."
    },
    "processing_ms": 2340
  }
}

Rate Limits

Unlimited
Requests per day
10 MB
Max image size
Upgrade to Business