Vogoo.ai logoVogoo.ai
    • Image Tools
    • Text to Image
    • Image to Image
    • Background Remover
    • AI Image Upscaler
    • Photo Enhancer
    • Clothes Changer AI
    • Image Effects
    • SeaArt AI
    • AI Pixel Art Generator
    • Claymation Style Generator
    • 64x64 Pixel Art
    • AI Pixel Tileset Generator
    • Pixel Animation Maker
    • Video Tools
    • Text to Video
    • Image to Video
    • Animate Pictures
    • Reference to Video
    • AI Character Maker
    • Video to Video
    • Video Extend
    • AI Video Editor
    • Video Effects
    • Motion Control AI
    • AI Lip Sync Tool
    • AI Talking Avatar
    • Audio Tools
    • Text to Music
    • AI Music Video
    • Banner & Design
    • AI Twitter Header Generator
    • AI YouTube Banner Maker
    • AI Album Cover Generator
    • AI Flyer Generator
    • Black Friday Poster Maker
    • AI Wallpaper Generator
      • Free Tools
      • Aspect Ratio Calculator
    • Image Effects
    • AI Halloween Photo Generator
    • AI Christmas Photo Generator
    • Sheru Bhai AI
    • Video Effects
    • Turkey Dance AI
    • Flamingo Float AI
    • Hotel Lobby AI
    • Tiny Desk AI
    • Chipmunks Dance AI
    • Crazy Frog AI
    • W Chews AI
    • Police Chase AI
    • Mandem in Disguise AI
    • Kids Drawing to Life AI
    • Video Effects
    • Kung Fu Cat AI
    • AI Zombie Video
    • Snow Leopard Paws at You AI
    • 58th Floor AI
    • Closing Door Prank AI
    • Diwali AI Video
    • AI Rap Video
    • Fancy Cafe AI
    • Bicep Heart Trend AI
    • Image Models
    • Nano Banana 2 Lite
    • Reve 2.1
    • GPT Image 2.6
    • GPT Image 2.5
    • Seedream 5.5
    • Seedream 5.0 Pro
    • Qwen Image 3.0
    • Seedream 5.0 Lite
    • Gemini Omni Flash
    • Video Models
    • Kling 4.0
    • Kling 3
    • Kling 2.6 Motion Control
    • Kling 3.0 Pro
    • Kling 3.0 Turbo
    • Kling 3.0 Motion Control
    • Flux 3
    • LTX 2.5
    • MiniMax H3
    • MiniMax H3 Max
    • HappyHorse 1.0
    • Seedance 2.5
    • Seedance 2.5 Flash
    • Seedance 2.0 Mini
    • Wan 2.7
  • Prompts
  • API
  • Blog
  • Pricing
Vogoo.ai logoVogoo.ai
Vogoo.ai

The free AI Picture Generator that exports at exact pixel image sizes — start from a prompt template, post without cropping.

X (Twitter)

Ask AI about Vogoo

Product
  • Text to Video
  • Image to Video
  • Animate Pictures
  • Text to Image
  • Image to Image
  • Text to Music
  • AI Album Cover Generator
  • AI Flyer Generator
  • Black Friday Poster Maker
  • AI Wallpaper Generator
  • AI Pixel Art Generator
  • Claymation Style Generator
  • 64x64 Pixel Art
  • AI Pixel Tileset Generator
  • Pixel Animation Maker
  • Motion Control AI
  • Turkey Dance AI
  • Sheru Bhai AI
  • Flamingo Float AI
  • Hotel Lobby AI
  • Tiny Desk AI
  • Chipmunks Dance AI
  • Crazy Frog AI
  • W Chews AI
  • Police Chase AI
  • Mandem in Disguise AI
  • Kids Drawing to Life AI
  • Kung Fu Cat AI
  • AI Zombie Video
  • Snow Leopard Paws at You AI
  • 58th Floor AI
  • Closing Door Prank AI
  • Diwali AI Video
  • Fancy Cafe AI
  • Bicep Heart Trend AI
  • AI Rap Video
  • AI Halloween Photo Generator
  • AI Christmas Photo Generator
  • Pricing
AI Models
  • Kling 4.0
  • Kling 3
  • Kling 2.6 Motion Control
  • Kling 3.0 Motion Control
  • Kling 3.0 Pro
  • Kling 3.0 Turbo
  • Reve 2.0
  • Reve 2.1
  • Nano Banana 2 Lite
  • GPT Image 2.6
  • GPT Image 2.5
  • Seedream 5.5
  • Seedream 5.0 Pro
  • Qwen Image 3.0
  • Seedream 5.0 Lite
  • Gemini Omni Flash
  • Flux 3
  • LTX 2.5
  • MiniMax H3
  • MiniMax H3 Max
  • HappyHorse 1.0
  • Seedance 2.5
  • Seedance 2.5 Flash
  • Seedance 2.0 Mini
  • Wan 2.7
  • iLoveSong AI
  • SeaArt AI
Company
  • About
  • Contact us
Legal
  • Cookie Policy
  • Privacy Policy
  • Terms of Service
  • Refund Policy
© 2026 Vogoo.ai. All Rights Reserved.
Vogoo.ai/Vogoo API/Docs

Vogoo API Docs

Everything you need to call the API. Requests are async: submit a generation, then poll it until the outputs are ready. Base URL https://vogoo.ai/api/v1

Create API Key
  • Authentication
  • List Models
  • Create a Generation
  • Get a Generation
  • Generation Object
  • Errors
  • Limits and Billing

Authentication

Create a key on the API Keys page. Keys start with vogoo_ and act as your account, so keep them on the server. Send the key in either header:

Authorization: Bearer vogoo_xxxxxxxxxxxx
# or
x-api-key: vogoo_xxxxxxxxxxxx

List Models

GET/api/v1/modelsNo key needed

Every model you can call, with its media type, supported tasks and credit cost. Browse the same list in the models market.

curl https://vogoo.ai/api/v1/models
{
  "object": "list",
  "data": [
    {
      "id": "nano-banana-2",
      "object": "model",
      "name": "Nano Banana 2",
      "brand": "Google",
      "type": "image",
      "scenes": ["text-to-image", "image-to-image"],
      "description": "…",
      "credits": "…",
      "max_resolution": "…",
      "duration": null,
      "estimated_time": "…"
    }
  ]
}

Create a Generation

POST/api/v1/generationsAPI key required

Submits a job and answers 202 with a generation object in queued or in_progress state.

FieldTypeDescription
modelstring, requiredA model id from the models market or GET /api/v1/models.
promptstringWhat to generate. Required unless options carries the full input.
scenestringOne of the model's tasks, such as text-to-video or image-to-video. Defaults to the first one.
optionsobjectModel settings such as aspect_ratio, duration, image_input (image models) or image_urls (video models). Unsupported keys are ignored.
enhance_promptbooleanLet Vogoo rewrite the prompt before it reaches the model. Default false.
curl https://vogoo.ai/api/v1/generations \
  -H "Authorization: Bearer $VOGOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "Studio product shot of a matte black sneaker, soft light",
    "options": { "aspect_ratio": "1:1" }
  }'

Get a Generation

GET/api/v1/generations/{id}API key required

Returns the current state. Poll every few seconds until status is completed, failed or canceled. You can only read generations created by your own account.

// Node.js 18+: submit, then poll until done
const headers = {
  Authorization: `Bearer ${process.env.VOGOO_API_KEY}`,
  'Content-Type': 'application/json',
};
let gen = await fetch('https://vogoo.ai/api/v1/generations', {
  method: 'POST',
  headers,
  body: JSON.stringify({ model: 'nano-banana-2', prompt: 'A cat astronaut' }),
}).then((r) => r.json());

while (gen.status === 'queued' || gen.status === 'in_progress') {
  await new Promise((r) => setTimeout(r, 5000));
  gen = await fetch(`https://vogoo.ai/api/v1/generations/${gen.id}`, { headers })
    .then((r) => r.json());
}
console.log(gen.outputs);

Generation Object

{
  "id": "…",
  "object": "generation",
  "status": "completed",   // queued | in_progress | completed | failed | canceled
  "model": "nano-banana-2",
  "model_name": "Nano Banana 2",
  "type": "image",
  "scene": "text-to-image",
  "prompt": "A cat astronaut",
  "outputs": [
    { "type": "image", "url": "https://…" }
    // video: { "type": "video", "url", "thumbnail_url", "duration" }
    // audio: { "type": "audio", "url", "thumbnail_url", "title", "duration" }
  ],
  "error": null            // { "code", "message" } when status is failed
}

outputs stays empty until the generation completes. Download the files you want to keep.

Errors

Every error has the same shape. param is set when a request field is invalid.

{ "error": { "code": "INVALID_REQUEST", "message": "…", "param": "model" } }
StatusCodeMeaning
400INVALID_REQUESTBad JSON, unknown model or scene, missing prompt.
400GENERATION_FAILEDThe model rejected the input.
401UNAUTHORIZEDMissing or invalid API key.
402INSUFFICIENT_CREDITSNot enough credits for this generation.
403FORBIDDENAccount suspended, email not verified, or the model needs a paid plan.
404NOT_FOUNDNo generation with that id on your account.
422CONTENT_POLICYPrompt or input blocked by moderation.
429RATE_LIMITEDToo many requests or too many jobs running at once.
503SERVICE_UNAVAILABLEUpstream model busy or timed out. Retry later.
500INTERNAL_ERRORUnexpected error on our side.

Limits and Billing

  • Each key allows 120 requests per minute.
  • Generations cost the same credits as the studio and are charged to the key owner's balance. Failed generations are refunded, except outputs blocked by moderation.
  • API generations also appear in your studio history.