📘 Welcome to ImageAI Pro Docs

ImageAI Pro provides a unified API gateway to 30+ state-of-the-art AI models. Build intelligent applications with a single line of code — whether you need computer vision, language models, or audio generation.

Our API follows RESTful conventions and returns JSON responses. All requests require an API key passed via the Authorization header.

curl -X GET https://api.imageaipro.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

⚡ Quickstart Guide

Get your first API request running in under 5 minutes.

1. Get an API Key

Sign up at dashboard.imageaipro.com and navigate to API Keys to generate your first key.

2. Make your first request

import requests

response = requests.post(
    "https://api.imageaipro.com/v1/chat/completions",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "gpt-4",
        "messages": [{"role": "user", "content": "Hello AI!"}]
    }
)
print(response.json())

🔑 Authentication

All API requests must include your API key in the Authorization header.

Authorization: Bearer sk_live_xxxxxxxxxxxxx

You can manage your keys from the dashboard. Keep your secret keys secure and never expose them in client-side code.

🖼️ Vision API

Analyze images with state-of-the-art computer vision models.

{
  "model": "vision-pro",
  "image_url": "https://example.com/image.jpg",
  "task": "object_detection"
}

response = client.vision.analyze(
    image_url="https://example.com/photo.jpg",
    task="caption"
)

🤖 LLM Completion

Access GPT-4, Claude, Llama 3, and more through a single endpoint.

{
  "model": "claude-3-opus",
  "messages": [{"role": "user", "content": "Explain quantum computing"}],
  "temperature": 0.7
}

🔍 Embeddings

Convert text into vector embeddings for semantic search and RAG applications.

embedding = client.embeddings.create(
    model="text-embedding-3",
    input="Your text here"
)

📦 Official SDKs

We provide first-party SDKs for Python and JavaScript.

Python

pip install imageai-pro

from imageai import ImageAI
client = ImageAI(api_key="YOUR_KEY")
response = client.chat.completions.create(model="gpt-4", messages=[...])

JavaScript/Node.js

npm install imageai-pro-sdk

import ImageAI from 'imageai-pro-sdk';
const client = new ImageAI({ apiKey: 'YOUR_KEY' });

🔔 Webhooks

Receive real-time notifications for async operations.

{
  "webhook_url": "https://your-app.com/webhook",
  "events": ["job.completed", "job.failed"]
}

⏱️ Rate Limits

Free tier: 10 requests per second. Enterprise: up to 500 RPS.

Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

⚠️ Error Codes

Common API errors and how to resolve them.

📋 Changelog

v2.4.0 Added support for GPT-4 Turbo (Dec 2024)

v2.3.0 Webhooks now support batch processing

v2.2.0 Vision API added with object detection