Vogoo.ai logoVogoo.ai
    • Bild-Tools
    • Text zu Bild
    • Bild zu Bild
    • Bildeffekte
    • SeaArt AI
    • Video-Tools
    • Text zu Video
    • Animate Pictures
    • Referenz zu Video
    • Video zu Video
    • Videoeffekte
    • Audio-Tools
    • Text zu Musik
    • KI-Musikvideo
    • Banner & Design
    • Black-Friday-Poster-Generator
    • Bildeffekte
    • KI-Halloween-Foto-Generator
    • Videomodelle
    • Kling 3
    • Kling 2.6 Motion Control
    • Kling 3.0 Pro
    • Kling 3.0 Turbo
    • Kling 3.0 Motion Control
    • MiniMax H3
    • MiniMax H3 Max
  • API
  • Blog
  • Preise
Vogoo.ai logoVogoo.ai
Vogoo.ai

Der kostenlose KI-Bildgenerator, der exakt in der gewünschten Pixelgröße exportiert — starte mit einer Prompt-Vorlage und poste ohne Zuschneiden.

X (Twitter)

Ask AI about Vogoo

Produkt
  • Text zu Video
  • Animate Pictures
  • Text zu Bild
  • Bild zu Bild
  • Text zu Musik
  • Black-Friday-Poster-Generator
  • KI-Halloween-Foto-Generator
  • Preise
KI-Modelle
  • Kling 3
  • Kling 2.6 Motion Control
  • Kling 3.0 Motion Control
  • Kling 3.0 Pro
  • Kling 3.0 Turbo
  • MiniMax H3
  • MiniMax H3 Max
  • SeaArt AI
Unternehmen
  • Über uns
  • Kontakt aufnehmen
Rechtliches
  • Cookie-Richtlinie
  • Datenschutzerklärung
  • Nutzungsbedingungen
  • Rückerstattungsrichtlinie
© 2026 Vogoo.ai. Alle Rechte vorbehalten.
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.