---
name: vision
description: Analyze images using GPT-4o Vision through the verging.ai proxy API, supporting both image URL (JSON) and file upload (multipart) modes.
---

# AI Vision Analysis — verging.ai

Analyze images using GPT-4o Vision through the verging.ai proxy API. Supports both image URL and file upload.

## Authentication

All requests require an API key in the `Authorization` header:

```
Authorization: ApiKey vrg_sk_xxx
```

Replace `vrg_sk_xxx` with your verging.ai API key. You can generate one at https://verging.ai under your account settings.

## Endpoints

### Option A — Image URL (JSON)

```
POST https://verging.ai/api/v1/ai/vision
Content-Type: application/json
```

### Option B — File Upload (multipart)

```
POST https://verging.ai/api/v1/ai/vision/upload
Content-Type: multipart/form-data
```

## Parameters

### JSON (URL mode)

| Parameter  | Type   | Required | Default | Description                              |
|------------|--------|----------|---------|------------------------------------------|
| prompt     | string | Yes      | —       | Analysis instruction / question          |
| image_url  | string | Yes      | —       | URL of the image to analyze              |
| model      | string | No       | gpt-4o  | Vision model                             |
| max_tokens | int    | No       | 1024    | Maximum tokens in the response           |

### Multipart (file upload mode)

| Parameter  | Type   | Required | Default | Description                              |
|------------|--------|----------|---------|------------------------------------------|
| prompt     | string | Yes      | —       | Analysis instruction / question          |
| file       | file   | Yes      | —       | Image file to analyze                    |
| model      | string | No       | gpt-4o  | Vision model                             |
| max_tokens | int    | No       | 1024    | Maximum tokens in the response           |

Requires a minimum balance of **5 credits** before calling (post-deduct billing).

## Examples

### Image URL

```bash
curl -X POST https://verging.ai/api/v1/ai/vision \
  -H "Authorization: ApiKey vrg_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Describe what you see in this image in detail.",
    "image_url": "https://example.com/photo.jpg",
    "max_tokens": 512
  }'
```

### File Upload

```bash
curl -X POST https://verging.ai/api/v1/ai/vision/upload \
  -H "Authorization: ApiKey vrg_sk_xxx" \
  -F "prompt=What objects are in this image?" \
  -F "file=@photo.jpg"
```

## Response

```json
{
  "content": "The image shows a modern office space with several desks...",
  "usage": {
    "prompt_tokens": 1100,
    "completion_tokens": 95,
    "total_tokens": 1195
  },
  "credits_consumed": 2
}
```

- `content` — The analysis result text.
- `usage` — Token usage breakdown.
- `credits_consumed` — Credits deducted for this request.

## Credits

| Component  | Rate                    |
|------------|-------------------------|
| Base fee   | 2 credits               |
| Input tokens  | 1 credit / 10K tokens |
| Output tokens | 3 credits / 10K tokens |

Minimum charge: **2 credits** per request.

## Error Codes

| HTTP Status | Error Code | Description                                      |
|-------------|------------|--------------------------------------------------|
| 402         | 40001      | Insufficient credits (minimum 5 required)        |
| 429         | —          | Rate limit exceeded (check `X-RateLimit-Reset`)  |
| 502         | —          | Upstream provider error                          |
| 503         | —          | Service unavailable or upstream timeout          |

Error response format:

```json
{
  "error_code": 40001,
  "message": "Insufficient credits. Required: 5, available: 2",
  "upstream_error": null
}
```