Vogoo.ai logoVogoo.ai
    • Herramientas de imagen
    • Texto a imagen
    • Imagen a imagen
    • Efectos de imagen
    • SeaArt AI
    • Herramientas de video
    • Texto a video
    • Animate Pictures
    • Referencia a video
    • Video a video
    • Efectos de video
    • Herramientas de audio
    • Texto a música
    • Video musical con IA
    • Banners y diseño
    • Creador de carteles Black Friday
    • Efectos de imagen
    • Generador de fotos de Halloween con IA
    • Modelos de video
    • 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
  • Precios
Vogoo.ai logoVogoo.ai
Vogoo.ai

El generador de imágenes con IA gratuito que exporta en tamaños de píxel exactos: empieza desde una plantilla de prompt y publica sin recortar.

X (Twitter)

Ask AI about Vogoo

Producto
  • Texto a video
  • Animate Pictures
  • Texto a imagen
  • Imagen a imagen
  • Texto a música
  • Creador de carteles Black Friday
  • Generador de fotos de Halloween con IA
  • Precios
Modelos de IA
  • 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
Empresa
  • Acerca de
  • Contáctanos
Legal
  • Política de cookies
  • Política de privacidad
  • Términos del servicio
  • Política de reembolsos
© 2026 Vogoo.ai. Todos los derechos reservados.
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.