vision

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

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

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

{
  "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:

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