Vogoo.ai logoVogoo.ai
    • เครื่องมือรูปภาพ
    • ข้อความเป็นภาพ
    • ภาพเป็นภาพ
    • เอฟเฟกต์ภาพ
    • SeaArt AI
    • เครื่องมือวิดีโอ
    • ข้อความเป็นวิดีโอ
    • Animate Pictures
    • ภาพอ้างอิงเป็นวิดีโอ
    • วิดีโอเป็นวิดีโอ
    • เอฟเฟกต์วิดีโอ
    • เครื่องมือเสียง
    • ข้อความเป็นเพลง
    • มิวสิกวิดีโอ AI
    • แบนเนอร์และงานออกแบบ
    • เครื่องมือสร้างโปสเตอร์ Black Friday
    • เอฟเฟกต์ภาพ
    • ตัวสร้างรูปฮาโลวีน AI
    • โมเดลวิดีโอ
    • Kling 3
    • Kling 2.6 Motion Control
    • Kling 3.0 Pro
    • Kling 3.0 Turbo
    • Kling 3.0 Motion Control
  • API
  • บล็อก
  • ราคา
Vogoo.ai logoVogoo.ai
Vogoo.ai

ตัวสร้างภาพ AI ฟรีที่ส่งออกได้ตรงตามขนาดพิกเซลเป๊ะ — เริ่มจากเทมเพลตพรอมต์ แล้วโพสต์ได้เลยโดยไม่ต้องครอป

X (Twitter)

Ask AI about Vogoo

ผลิตภัณฑ์
  • ข้อความเป็นวิดีโอ
  • Animate Pictures
  • ข้อความเป็นภาพ
  • ภาพเป็นภาพ
  • ข้อความเป็นเพลง
  • เครื่องมือสร้างโปสเตอร์ Black Friday
  • ตัวสร้างรูปฮาโลวีน AI
  • ราคา
โมเดล AI
  • Kling 3
  • Kling 2.6 Motion Control
  • Kling 3.0 Motion Control
  • Kling 3.0 Pro
  • Kling 3.0 Turbo
  • SeaArt AI
บริษัท
  • เกี่ยวกับเรา
  • ติดต่อเรา
ข้อกฎหมาย
  • นโยบายคุกกี้
  • นโยบายความเป็นส่วนตัว
  • ข้อกำหนดการให้บริการ
  • นโยบายการคืนเงิน
© 2026 Vogoo.ai. สงวนลิขสิทธิ์ทั้งหมด
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.