Documentation

Get Started with Aionvision API in 5 Minutes

Complete guide from account creation to your first successful API call

Step 1: Create Your Account (1 minute)

1. Visit aionvision.tech/auth/register

2. Sign up with Google (no email verification required) — or enter your email and create a password

3. If signing up with email, verify your email address

4. Complete your profile setup

Step 2: Upgrade Your Plan (1 minute)

⚠️ API Access Requirement

API access requires a paid plan. The Free tier does not include API access.

Paid plans include:

Full REST API access
Python SDK included
Higher upload limits
API rate limit allowance

View Pricing →

Step 3: Create Your API Key (1 minute)

1. Navigate to Dashboard → API Keys tab

2. Click "Create New API Key"

3. Give your key a descriptive name (e.g., "Production API")

4. Copy the API key - format: aion_...

5. Store it securely (it's shown only once!)

Go to Dashboard →

Step 4: Make Your First API Call (2 minutes)

Choose your preferred method below. We recommend starting with the Python SDK for the best experience.

Option A: Python SDK (Recommended)

The official Python SDK provides the easiest and most robust way to integrate with Aionvision.

# Install the SDK (use the API key you just created)
pip install aion --extra-index-url https://aion:aion_YOUR_KEY_HERE@api.aionvision.tech/api/v2/sdk/simple/

import asyncio
from aion import AionVision

async def main():
    # Initialize client with your API key
    async with AionVision(api_key="aion_YOUR_KEY_HERE") as client:
        # Upload and describe an image in one call
        result = await client.upload_one("path/to/photo.jpg")

        # Print the AI-generated description
        print(f"Description: {result.description}")
        print(f"Image ID: {result.image_id}")

# Run the async function
asyncio.run(main())

View full SDK documentation →

Option B: REST API - Streaming Upload (Simplest)

For direct HTTP integration, use the streaming upload endpoint for single-step uploads.

curl -X POST https://api.aionvision.tech/api/v2/user-files/upload/stream \
  -H "Authorization: Bearer aion_YOUR_KEY_HERE" \
  -F "file=@photo.jpg"

# Response includes:
# - image_id: Unique identifier for your uploaded image
# - status: "completed" or "processing"
# - description_queued: true if AI description is being generated

📦 For Large Files

The streaming upload works great for files up to 100MB. For larger files, use the presigned URL flow which handles uploads in chunks.

View complete API reference →

Coding with AI? Index this repo

If you're using an AI coding assistant (Cursor, Copilot, Claude Code, etc.), point it at our GitHub repository so it can reference the SDK source, types, and examples directly.

What's Next?

📚 API Reference

Explore all 15 endpoint categories

💡 Code Examples

Advanced use cases and patterns

📖 Guides

Uploads, search, chat, batch processing

Troubleshooting

❌ "Invalid API key"

→ Double-check you copied the full key including the aion_ prefix

❌ "Insufficient subscription tier"

→ Your account is on the Free tier. Upgrade to STARTER or higher at /pricing

❌ "Rate limit exceeded"

→ Rate limits: STARTER (30/min), PROFESSIONAL (100/min), ENTERPRISE (500/min). Wait a minute or upgrade your plan.

⚠️ Still having issues?

Contact support at support@aionvision.tech or check our authentication guide