Vogoo.ai logoVogoo.ai
    • Görsel Araçları
    • Metinden Görsele
    • Görselden Görsele
    • Görsel Efektleri
    • SeaArt AI
    • Video Araçları
    • Metinden Videoya
    • Animate Pictures
    • Referanstan Videoya
    • Videodan Videoya
    • Video Efektleri
    • Ses Araçları
    • Metinden Müziğe
    • AI Müzik Videosu
    • Banner ve Tasarım
    • Black Friday Poster Oluşturucu
    • Görsel Efektleri
    • Yapay Zeka Cadılar Bayramı Fotoğraf Oluşturucu
    • Video Modelleri
    • Kling 3
    • Kling 2.6 Motion Control
    • Kling 3.0 Pro
    • Kling 3.0 Turbo
    • Kling 3.0 Motion Control
  • API
  • Blog
  • Fiyatlandırma
Vogoo.ai logoVogoo.ai
Vogoo.ai

Tam piksel ölçülerinde dışa aktaran ücretsiz AI görsel oluşturucu — bir prompt şablonuyla başla, kırpmadan paylaş.

X (Twitter)

Ask AI about Vogoo

Ürün
  • Metinden Videoya
  • Animate Pictures
  • Metinden Görsele
  • Görselden Görsele
  • Metinden Müziğe
  • Black Friday Poster Oluşturucu
  • Yapay Zeka Cadılar Bayramı Fotoğraf Oluşturucu
  • Fiyatlandırma
AI Modelleri
  • Kling 3
  • Kling 2.6 Motion Control
  • Kling 3.0 Motion Control
  • Kling 3.0 Pro
  • Kling 3.0 Turbo
  • SeaArt AI
Şirket
  • Hakkımızda
  • Bize ulaş
Yasal
  • Çerez Politikası
  • Gizlilik Politikası
  • Hizmet Şartları
  • İade Politikası
© 2026 Vogoo.ai. Tüm Hakları Saklıdır.
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.