Verging AI API Documentation

Authentication

All API requests require an API key. Include it in the Authorization header:

Authorization: ApiKey vrg_sk_your_api_key_here

Generate API keys from your account dashboard at verging.ai (click your avatar → API Keys). The full key is shown only once at creation — store it securely.

Credits & Pricing

All services are billed using credits. Purchase credits at $10 = 530 credits.

Error Handling

All errors follow a consistent JSON format:

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

Rate Limits

AI Proxy services are rate-limited per user. When rate-limited, the response includes a 429 status code. Check the X-RateLimit-Reset header for when you can retry.

Swap faces in videos with AI precision. Supports HD processing and async job tracking. Try it online →

Create Job

Content-Type: multipart/form-data

curl -X POST https://verging.ai/api/v1/faceswap/create-job \
  -H "Authorization: ApiKey vrg_sk_xxx" \
  -F "swap_image=@face.jpg" \
  -F "file_name=video.mp4" \
  -F "target_video_url=https://cdn.verging.ai/uploads/video.mp4" \
  -F "user_video_duration=30" \
  -F "is_hd=false"

Response includes job_id. Poll the jobs endpoint for status updates.

List Jobs

Retry Failed Job

Only failed jobs can be retried. Credits are re-frozen for the retry.

Upscale video quality to high resolution using AI. Async job-based processing. Try it online →

Create Job

Content-Type: multipart/form-data

curl -X POST https://verging.ai/api/v1/video-enhance/create-job \
  -H "Authorization: ApiKey vrg_sk_xxx" \
  -F "file_name=video.mp4" \
  -F "target_video_url=https://cdn.verging.ai/uploads/video.mp4" \
  -F "user_video_duration=15"

Remove image backgrounds with AI. Fixed cost of 1 credit per image. Try it online →

Create Job

Content-Type: multipart/form-data

curl -X POST https://verging.ai/api/v1/background-removal/create-job \
  -H "Authorization: ApiKey vrg_sk_xxx" \
  -F "image=@photo.jpg" \
  -F "file_name=photo.jpg"

Generate AI images using DALL-E / gpt-image-1.

curl -X POST https://verging.ai/api/v1/ai/imagegen \
  -H "Authorization: ApiKey vrg_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic cityscape at sunset, digital art style",
    "quality": "hd",
    "n": 2
  }'

Response

{
  "images": [
    "https://cdn.verging.ai/proxy/imagegen/abc123.png"
  ],
  "credits_consumed": 3
}

Generate chat completions using GPT-4o. Supports streaming (SSE) and non-streaming responses. Requires minimum 5 credits balance.

Non-streaming

curl -X POST https://verging.ai/api/v1/ai/chat \
  -H "Authorization: ApiKey vrg_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Explain quantum computing in one paragraph."}
    ],
    "temperature": 0.7,
    "max_tokens": 256
  }'

Streaming (SSE)

curl -N -X POST https://verging.ai/api/v1/ai/chat \
  -H "Authorization: ApiKey vrg_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Write a haiku about coding."}],
    "stream": true
  }'

Response (non-streaming)

{
  "content": "Quantum computing leverages quantum mechanical phenomena...",
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 85,
    "total_tokens": 109
  },
  "credits_consumed": 1
}

Streaming responses use Server-Sent Events. Each chunk: data: {"content": "..."}. Final chunk includes usage and credits_consumed, followed by data: [DONE].

Convert text to speech audio using OpenAI TTS-1-HD.

curl -X POST https://verging.ai/api/v1/ai/tts \
  -H "Authorization: ApiKey vrg_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Hello! Welcome to Verging AI.",
    "voice": "nova",
    "speed": 1.1
  }'

Response

{
  "audio_url": "https://cdn.verging.ai/proxy/tts/abc123.mp3",
  "credits_consumed": 1
}

Transcribe audio to text using OpenAI Whisper. Supports mp3, mp4, mpeg, mpga, m4a, wav, webm (max 25MB).

Content-Type: multipart/form-data

curl -X POST https://verging.ai/api/v1/ai/stt \
  -H "Authorization: ApiKey vrg_sk_xxx" \
  -F "file=@recording.mp3" \
  -F "language=en"

Response

{
  "text": "Hello, this is a sample transcription.",
  "language": "en",
  "duration": 12.5,
  "credits_consumed": 1
}

Analyze images using GPT-4o Vision. Supports image URL and file upload. Requires minimum 5 credits balance.

Option A — 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.",
    "image_url": "https://example.com/photo.jpg"
  }'

Option B — 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
}

Query your AI proxy service usage history.

curl https://verging.ai/api/v1/ai/usage \
  -H "Authorization: ApiKey vrg_sk_xxx"

Response

{
  "records": [
    {
      "id": 1,
      "service_type": "chat",
      "credits_consumed": 3,
      "input_tokens": 24,
      "output_tokens": 85,
      "latency_ms": 1200,
      "status": "success",
      "created_at": "2026-03-20T10:30:00"
    }
  ],
  "total": 17,
  "page": 1,
  "page_size": 20
}

Manage your API keys. Create new keys from your account dashboard at verging.ai (avatar → API Keys). Keys use the prefix vrg_sk_.

List API Keys

Returns your API keys (prefix only, never the full key).

Delete API Key

Permanently revokes the specified API key.

Validate API Key

Test if your API key is valid and active.

curl -X POST https://verging.ai/api/v1/api-keys/validate \
  -H "Authorization: ApiKey vrg_sk_xxx"