Voor AI developer docs
Voor AI API
One REST API for the image, video and audio models on Voor AI. Requests spend the same credits as the website, and results appear in your History.
Base URL: https://voor.ai/v1
Authentication
Create a key on the API keys page and send it as a Bearer token. Keys are shown once; Voor stores only a hash. Revoke a key there and it stops working immediately.
Authorization: Bearer voor_sk_...Create a generation
POST /v1/generations with a model id and its input parameters (see each model's page). The price in credits is the same as on voor.ai. It is charged when the task is created and refunded automatically if the generation fails. Optional fields: callback_url (public https URL for the webhook), expected_credits (reject if the price differs) and public (default false). The response is 202 with the task.
curl https://voor.ai/v1/generations \
-H "Authorization: Bearer $VOOR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "851-labs/background-remover",
"input": {
"prompt": "A red fox standing in fresh snow at golden hour, soft light"
},
"callback_url": "https://example.com/webhooks/voor"
}'
# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
-H "Authorization: Bearer $VOOR_API_KEY"Idempotency
Send an Idempotency-Key header (1-255 printable characters, a UUID works) to retry safely. Repeating the same key with the same body returns the original task with Idempotent-Replayed: true and charges nothing. The same key with a different body returns 409 idempotency_key_conflict. Keys are scoped to the API key.
Task status
GET /v1/tasks/{id} returns the task. status is pending, running, completed, failed or cancelled. Output URLs follow the same rules as the website: paid accounts receive the clean file, free accounts the watermarked copy. GET /v1/account returns your credit balance. GET /v1/models and GET /v1/models/{id} need no key.
{
"id": "cm0abc123",
"object": "task",
"model": "MODEL_ID",
"status": "completed",
"created_at": "2026-10-20T08:00:00.000Z",
"completed_at": "2026-10-20T08:00:41.000Z",
"failed_at": null,
"credits_charged": 13,
"credits_refunded": 0,
"output": [
{ "type": "image", "url": "https://cdn.voor.ai/...", "width": 1024, "height": 1024 }
],
"error": null
}Webhooks
With a callback_url, Voor sends one POST when the task finishes (task.completed, task.failed or task.cancelled). Answer with any 2xx status within 10 seconds. Other answers are retried after 30 s, 2 min, 10 min, 30 min, 1 h, 3 h and 6 h. Each key has its own signing secret (whsec_...) on the API keys page. The Voor-Signature header is t=<unix seconds>,v1=<hex HMAC-SHA256 of "t.rawBody">; reject timestamps older than 5 minutes.
POST https://example.com/webhooks/voor
Content-Type: application/json
Voor-Event: task.completed
Voor-Webhook-Id: whd_cm0abc123
Voor-Signature: t=1792483241,v1=5f2b...e9
{ "id": "whd_cm0abc123", "object": "event", "type": "task.completed",
"created_at": "2026-10-20T08:00:41.000Z", "data": { ...task } }import { createHmac, timingSafeEqual } from "node:crypto";
// rawBody must be the exact bytes Voor sent, before JSON parsing.
export function verifyVoorSignature(rawBody, header, secret, toleranceSeconds = 300) {
const parts = Object.fromEntries(header.split(",").map((part) => part.split("=", 2)));
const timestamp = Number(parts.t);
if (!parts.v1 || Math.abs(Date.now() / 1000 - timestamp) > toleranceSeconds) return false;
const expected = createHmac("sha256", secret).update(`${timestamp}.${rawBody}`).digest();
const received = Buffer.from(parts.v1, "hex");
return received.length === expected.length && timingSafeEqual(received, expected);
}Errors and limits
Errors are JSON: { "error": { "code": "...", "message": "..." } }. Each key allows 60 requests per minute; every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Concurrent running tasks follow your account's website limit.
| Status | Codes | Meaning |
|---|---|---|
| 400 | invalid_request, invalid_input, invalid_json, invalid_callback_url, invalid_idempotency_key | Fix the request; nothing was charged. |
| 401 | invalid_api_key | Missing, malformed or revoked key. |
| 402 | insufficient_credits | Balance is below the price. The body has credits_required and balance. |
| 403 | account_restricted | The account cannot generate. |
| 404 | model_not_found, task_not_found | Unknown model id, or a task that is not yours. |
| 409 | idempotency_key_conflict, price_changed | Same Idempotency-Key with a different body, or expected_credits no longer matches. |
| 413 | request_too_large | Bodies are limited to 256 KB; pass media as URLs. |
| 429 | rate_limited, concurrency_limit | Wait for Retry-After seconds. |
| 503 | service_unavailable, service_busy | Retry later with the same Idempotency-Key. |
Models
3D
- trellis
firtoz · from 14 credits
- trellis2
fishwowater
- Meshy 7.1 (Meshy 7.1 Image to 3D)
Meshy · from 419 credits
- Meshy 7.1 (Meshy 7.1 Multi-Image to 3D)
Meshy · from 419 credits
- Meshy 7.1 (Meshy 7.1 Text to 3D)
Meshy · from 419 credits
- GPT-6 Astra Image to 3D
OpenAI · from 2787 credits
- GPT-6 Astra Text to 3D
OpenAI · from 2787 credits
- hunyuan3d-2
prunaai · from 77 credits
- hunyuan3d-2mv
tencent · from 42 credits
- pixal3d
Tencent · from 105 credits
- Tripo P2 (Tripo P2 Image to 3D)
Tripo · from 384 credits
- Tripo P2 (Tripo P2 Text to 3D)
Tripo · from 384 credits
Audio
- flash-v2.5
elevenlabs · from 1 credits
- turbo-v2.5
elevenlabs · from 1 credits
- v2-multilingual
elevenlabs · from 2 credits
- v3
elevenlabs · from 2 credits
- ElevenLabs v4 (v4 text to speech)
ElevenLabs · from 1 credits
- ElevenLabs v4 (v4 Turbo text to speech)
ElevenLabs · from 1 credits
- Gemini 3.8 Flash TTS (Flash Lite TTS)
Google · from 1 credits
- Gemini 3.8 Flash TTS (Flash TTS)
Google · from 1 credits
- Lyria 3.5
Google · from 35 credits
- musicgen
meta · from 21 credits
- music-01
minimax · from 13 credits
- music-1.5
minimax · from 11 credits
- speech-2.8-hd
minimax · from 1 credits
- speech-2.8-turbo
minimax · from 1 credits
- MiniMax Music 3
MiniMax · from 42 credits
- Mureka V9.5 (Instrumental)
Mureka · from 79 credits
- Mureka V9.5 (Lyrics to song)
Mureka · from 79 credits
- Mureka V9.5 (Prompt to song)
Mureka · from 262 credits
- speech-enhancer
playmore
- qwen3-tts
qwen · from 1 credits
- resemble-enhance
resemble-ai
Image
- background-remover
851-labs · from 1 credits
- FLUX 3 Image (Edit with references)
Black Forest Labs · from 17 credits
- FLUX 3 Image (Text to image)
Black Forest Labs · from 17 credits
- SDXL Lightning
Bytedance · from 1 credits
- Seedream 4
Bytedance · from 11 credits
- Seedream 4.5
Bytedance · from 14 credits
- Seedream 5 Flash (Edit image)
ByteDance · from 10 credits
- Seedream 5 Flash (Text to image)
ByteDance · from 10 credits
- Seedream 5 Lite (Edit image)
ByteDance · from 13 credits
- Seedream 5 Lite (Text to image)
ByteDance · from 13 credits
- Seedream 5 Pro (Edit image)
ByteDance · from 48 credits
- Seedream 5 Pro (Text to image)
ByteDance · from 48 credits
- Seedream 5.5 (Edit image)
ByteDance · from 10 credits
- Seedream 5.5 (Text to image)
ByteDance · from 7 credits
- Seedream 5.5 Transparent PNG
ByteDance · from 7 credits
- real-esrgan
cjwbw · from 2 credits
- crystal-upscaler
clarityai · from 6 credits
- FLUX 1.1 Pro Ultra
Flux AI · from 21 credits
- FLUX 2 Flex
Flux AI · from 21 credits
- FLUX 2 Klein 4B
Flux AI · from 1 credits
- FLUX 2 Max
Flux AI · from 11 credits
- FLUX 2 Pro
Flux AI · from 354 credits
- FLUX Dev
Flux AI · from 9 credits
- FLUX Kontext Max
Flux AI · from 28 credits
- FLUX Kontext Pro
Flux AI · from 14 credits
- FLUX Pro
Flux AI · from 20 credits
- FLUX Schnell
Flux AI · from 2 credits
- flux-1.1-pro
Flux AI · from 14 credits
- flux-2-dev
Flux AI · from 5 credits
- flux-2-klein-9b
Flux AI · from 6 credits
- flux-canny-dev
Flux AI · from 9 credits
- flux-canny-pro
Flux AI · from 18 credits
- flux-depth-dev
Flux AI · from 9 credits
- flux-depth-pro
Flux AI · from 18 credits
- flux-fill-pro
Flux AI · from 18 credits
- flux-kontext-dev
Flux AI · from 9 credits
- flux-redux-dev
Flux AI · from 9 credits
- cartoonify
flux-kontext-apps · from 14 credits
- change-haircut
flux-kontext-apps · from 14 credits
- depth-of-field
flux-kontext-apps · from 14 credits
- face-to-many-kontext
flux-kontext-apps · from 14 credits
- filters
flux-kontext-apps · from 14 credits
- iconic-locations
flux-kontext-apps · from 14 credits
- impossible-scenarios
flux-kontext-apps · from 14 credits
- kontext-emoji-maker
flux-kontext-apps · from 11 credits
- multi-image-kontext-max
flux-kontext-apps · from 28 credits
- multi-image-kontext-pro
flux-kontext-apps · from 14 credits
- multi-image-list
flux-kontext-apps · from 28 credits
- portrait-series
flux-kontext-apps · from 14 credits
- professional-headshot
flux-kontext-apps · from 14 credits
- renaissance
flux-kontext-apps · from 14 credits
- restore-image
flux-kontext-apps · from 14 credits
- restyle-video-frame
flux-kontext-apps
- text-removal
flux-kontext-apps · from 14 credits
- Imagen 3
google · from 18 credits
- Imagen 3 Fast
google · from 9 credits
- Imagen 4
google · from 14 credits
- Imagen 4 Fast
google · from 7 credits
- Imagen 4 Ultra
google · from 21 credits
- Nano Banana
google · from 14 credits
- Nano Banana 2
google · from 24 credits
- Nano Banana Pro (Edit image)
Google · from 53 credits
- Nano Banana Pro (Text to image)
Google · from 53 credits
- Ideogram 4.5 (Edit)
Ideogram · from 21 credits
- Ideogram 4.5 (Text to image)
Ideogram · from 21 credits
- Ideogram 2
ideogram-ai · from 28 credits
- Ideogram 2 Turbo
ideogram-ai · from 18 credits
- Ideogram 3 Quality
ideogram-ai · from 32 credits
- Ideogram 3 Turbo
ideogram-ai · from 11 credits
- Krea 2 (Krea 2 Large)
Krea · from 21 credits
- Krea 2 (Krea 2 Medium Turbo)
Krea · from 6 credits
- Krea 2 (Krea 2 Medium)
Krea · from 11 credits
- Krea 2 (Krea 2 style reference)
Krea · from 7 credits
- FLUX.1 Krea [dev]
Krea × Black Forest Labs · from 7 credits
- Muse Image (Edit and compose)
Meta · from 4 credits
- Muse Image (Text to image)
Meta · from 4 credits
- MAI Image 2.5 (Pro edit)
Microsoft · from 95 credits
- MAI Image 2.5 (Pro text to image)
Microsoft · from 60 credits
- MAI Image 2.5 (Standard edit)
Microsoft · from 25 credits
- MAI Image 2.5 (Standard text to image)
Microsoft · from 18 credits
- Midjourney v8.1
Midjourney · from 35 credits
- GPT Image 2 (Edit image)
OpenAI · from 7 credits
- GPT Image 2 (Text to image)
OpenAI · from 5 credits
- GPT Images 2.5 (Flare edit)
OpenAI · from 70 credits
- GPT Images 2.5 (Flare text to image)
OpenAI · from 42 credits
- GPT Images 2.5 (Sunburst edit)
OpenAI · from 105 credits
- GPT Images 2.5 (Sunburst text to image)
OpenAI · from 70 credits
- flux-kontext-fast
prunaai · from 4 credits
- p-image-edit
prunaai · from 4 credits
- Qwen Image
qwen · from 9 credits
- qwen-image-2512
qwen · from 7 credits
- qwen-image-edit
qwen · from 11 credits
- qwen-image-edit-2511
qwen · from 11 credits
- qwen-image-edit-plus
qwen · from 11 credits
- Qwen Image 3 (Edit image)
Qwen · from 27 credits
- Qwen Image 3 (Text to image)
Qwen · from 14 credits
- Recraft V4 (Pro)
Recraft · from 74 credits
- Recraft V4 (Standard)
Recraft · from 13 credits
- Recraft V4 (Vector (SVG))
Recraft · from 28 credits
- Recraft 3
recraft-ai · from 14 credits
- codeformer
sczhou · from 3 credits
- Stable Diffusion 3.5 Large
stability-ai · from 23 credits
- Stable Diffusion 3.5 Large Turbo
stability-ai · from 14 credits
- Stable Diffusion 3.5 Medium
stability-ai · from 13 credits
- Hunyuan Image 3
tencent · from 28 credits
- gfpgan
tencentarc · from 1 credits
- Wan 2.2 Image
Wan AI · from 7 credits
- Wan 2.7 Image
wan-video · from 11 credits
- Wan 2.7 Image Pro
wan-video · from 11 credits
- Grok Imagine Image
xai · from 7 credits
- Grok Imagine Image 2.0 (Edit image)
xAI · from 25 credits
- Grok Imagine Image 2.0 (Text to image)
xAI · from 21 credits
- esrgan
xinntao · from 1 credits
- Z-Image Turbo
Z Image · from 8 credits
Text
- deepseek-ocr
lucataco · from 2 credits
- img2prompt
methexis-inc · from 5 credits
- clip-interrogator
pharmapsychotic · from 1 credits
- llava-13b
yorickvp · from 2 credits
Video
- HappyHorse 1.1 (Image to video)
alibaba · from 244 credits
- HappyHorse 1.1 (Reference to video)
alibaba · from 244 credits
- HappyHorse 1.1 (Text to video)
alibaba · from 244 credits
- FLUX 3 (Extend · draft)
Black Forest Labs
- FLUX 3 (Extend a clip)
Black Forest Labs
- FLUX 3 (First & last · draft)
Black Forest Labs · from 105 credits
- FLUX 3 (First & last frame)
Black Forest Labs · from 297 credits
- FLUX 3 (Image to video · draft)
Black Forest Labs · from 105 credits
- FLUX 3 (Image to video)
Black Forest Labs · from 297 credits
- FLUX 3 (Text to video · draft)
Black Forest Labs · from 105 credits
- FLUX 3 (Text to video)
Black Forest Labs · from 297 credits
- Seedance 2.0
ByteDance · from 210 credits
- Seedance 2.0 Fast
ByteDance · from 122 credits
- Seedance 2.0 Mini (Image to video)
ByteDance · from 377 credits
- Seedance 2.0 Mini (Reference to video)
ByteDance · from 377 credits
- Seedance 2.0 Mini (Text to video)
ByteDance · from 377 credits
- Seedance 2.5
ByteDance · from 314 credits
- Veo 3
google · from 558 credits
- Veo 3 Fast
google · from 210 credits
- Veo 3.1
google · from 558 credits
- Veo 3.1 Fast
google · from 419 credits
- Gemini Omni 1.1 Flash (Edit video)
Google
- Gemini Omni 1.1 Flash (Image to video)
Google · from 84 credits
- Gemini Omni 1.1 Flash (Reference to video)
Google · from 84 credits
- Gemini Omni 1.1 Flash (Text to video)
Google · from 84 credits
- Gemini Omni 1.2 Flash (Image to video)
Google · from 77 credits
- Gemini Omni 1.2 Flash (Text to video)
Google · from 77 credits
- Gemini Omni Flash (Edit video)
Google
- Gemini Omni Flash (Image to video)
Google · from 363 credits
- Gemini Omni Flash (Reference to video)
Google · from 363 credits
- HappyHorse 1.0 (Edit video)
Happy Horse
- HappyHorse 1.0 (Image to video)
Happy Horse · from 488 credits
- HappyHorse 1.0 (Reference to video)
Happy Horse · from 147 credits
- HappyHorse 1.0 (Text to video)
Happy Horse · from 147 credits
- Kling 2.1
Kling · from 88 credits
- Kling 2.5 Turbo Pro
Kling · from 122 credits
- Kling 2.6
Kling · from 244 credits
- Kling 3.0
Kling · from 293 credits
- Kling 3.0 Motion Control
Kling
- Kling 3.0 Turbo Pro
Kling · from 244 credits
- Kling O1
Kling · from 1742 credits
- kling-v2.6-motion-control
Kling
- kling-v3-omni-video
Kling · from 293 credits
- LTX 2.5 (Fast audio to video)
Lightricks
- LTX 2.5 (Fast image to video)
Lightricks · from 272 credits
- LTX 2.5 (Fast text to video)
Lightricks · from 272 credits
- LTX 2.5 (Pro audio to video)
Lightricks
- LTX 2.5 (Pro image to video)
Lightricks · from 356 credits
- LTX 2.5 (Pro text to video)
Lightricks · from 356 credits
- real-esrgan-video
lucataco
- Hailuo 2.3
MiniMax · from 98 credits
- Hailuo 2.3 Fast
MiniMax · from 67 credits
- MiniMax H3
MiniMax · from 70 credits
- MiniMax H3 Max (Image to video)
MiniMax · from 50 credits
- MiniMax H3 Max (Text to video)
MiniMax · from 50 credits
- MiniMax H3 Max Turbo (Image to video)
MiniMax · from 44 credits
- MiniMax H3 Max Turbo (Text to video)
MiniMax · from 44 credits
- Sora 2
openai · from 140 credits
- Sora 2 Pro
openai · from 419 credits
- PixVerse 4.5
pixverse · from 105 credits
- PixVerse 5
pixverse · from 105 credits
- PixVerse 5.6
pixverse · from 122 credits
- PixVerse V6 (Extend a clip)
PixVerse
- PixVerse V6 (First & last frame)
PixVerse · from 79 credits
- PixVerse V6 (Image to video)
PixVerse · from 79 credits
- PixVerse V6 (Text to video)
PixVerse · from 79 credits
- Hunyuan Video
tencent · from 439 credits
- video-upscale
topazlabs
- Vidu Q3 (Image to video)
Vidu · from 122 credits
- Vidu Q3 (Text to video)
Vidu · from 122 credits
- Vidu Q3 Turbo (Image to video)
Vidu · from 61 credits
- Vidu Q3 Turbo (Text to video)
Vidu · from 61 credits
- Alors on Danse AI
Voor
- Bad Times AI
Voor · from 439 credits
- Bulin 47 AI
Voor · from 439 credits
- Burning Bridges AI
Voor · from 439 credits
- ChatGPT Millionaire AI
Voor · from 1511 credits
- Crazy Frog AI
Voor · from 1427 credits
- Enzo Fernandez Celebration AI
Voor · from 469 credits
- Gas Station Dance
Voor · from 439 credits
- Ghost Filter Prank
Voor · from 539 credits
- Hotel Lobby AI
Voor
- Jean Phil AI
Voor · from 439 credits
- Ozil Goal AI
Voor · from 439 credits
- Raindance AI
Voor
- Rap Duo AI
Voor
- Sheru Bhai
Voor · from 539 credits
- Unforgettable Car AI
Voor · from 439 credits
- Wan 2.2 Animate 2
Wan
- Wan 2.2 Fast
Wan AI · from 18 credits
- Wan 2.5
Wan AI · from 88 credits
- Wan 2.5 Fast
Wan AI · from 119 credits
- Wan 2.6 (Image to video)
Wan AI · from 175 credits
- Wan 2.6 (Text to video)
Wan AI · from 175 credits
- Wan 2.7 (Image to video)
Wan AI · from 175 credits
- Wan 2.7 (Reference to video)
Wan AI · from 175 credits
- Wan 2.7 (Text to video)
Wan AI · from 175 credits
- Wan 3.0 (Image to video)
Wan AI · from 88 credits
- Wan 3.0 (Reference to video)
Wan AI · from 88 credits
- Wan 3.0 (Text to video)
Wan AI · from 88 credits
- Wan 3.0 Prime (Image to video)
Wan AI · from 119 credits
- Wan 3.0 Prime (Reference to video)
Wan AI · from 119 credits
- Wan 3.0 Prime (Text to video)
Wan AI · from 119 credits
- Wan 2.6 Flash
wan-video · from 88 credits
- Grok Imagine Video
xai · from 88 credits
- grok-imagine-video-extension
xai
- Grok Imagine Video 1.5 (Image to video)
xAI · from 297 credits
- Grok Imagine Video 1.5 (Lite image to video)
xAI · from 67 credits
- Grok Imagine Video 1.5 (Lite text to video)
xAI · from 63 credits
- Grok Imagine Video 1.5 (Reference to video)
xAI · from 227 credits
- Grok Imagine Video 1.5 (Text to video)
xAI · from 293 credits