Veo 3 Video API Reference | Nano Banana Pro API

Veo3

Google's Veo 3 для создания высококачественного видео

Endpoint: POST /api/v1/videos/generate
model: veo3
Output: Video
Credits: from 30

Отправить задачу

POST/api/v1/videos/generate

Параметры

modelstringТребуется
"veo3" or "veo3_fast"
veo3veo3_fast
typestringОпциональноПо умолчанию text-to-video
"text-to-video" or "image-to-video" (default: text-to-video)
text-to-videoimage-to-video
promptstringТребуется
Text description of the video
image_urlsstring[]Опционально
Input image URLs for image-to-video
input_imagestringОпционально
Deprecated. Alias for image_urls[0]
aspect_ratiostringОпционально
"16:9", "9:16", or "Auto" (aliases: "landscape", "portrait", "square")
16:99:16Autolandscapeportraitsquare
watermarkbooleanОпциональноПо умолчанию true
Include watermark (default: true)
truefalse
seedsnumberОпционально
Random seed for reproducibility
enable_fallbackbooleanОпционально
Retry on a backup generation channel if the first attempt fails
truefalse
enable_translationbooleanОпционально
Auto-translate non-English prompts
truefalse

Запрос

curl -X POST https://www.bananapro.site/api/v1/videos/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3",
    "prompt": "A drone shot flying over a tropical beach at sunset",
    "aspect_ratio": "16:9"
  }'

Ответ200

JSON

{
  "success": true,
  "data": {
    "task_id": "task_veo123",
    "credits_used": 130,
    "remaining_credits": 370,
    "model": "veo3"
  }
}

Значения credits_used в этих примерах приведены для иллюстрации. Фактический расход рассчитывается при отправке и возвращается API.

Запросить задачу

GET/api/v1/videos/{task_id}

status

pending: Accepted and waiting to start. Keep polling.
processing: Running. Keep polling.
completed: Finished. Read video_url; output holds the full result.
failed: Ended without a result. error_message says why and credits_refunded shows what was returned.

Poll every 5 to 10 seconds and stop at completed or failed, or register a webhook to be notified instead. Failed tasks are refunded automatically.

Запрос

curl https://www.bananapro.site/api/v1/videos/task_abc123 \
  -H "Authorization: Bearer sk-your-api-key"

Ответ200

JSON

{
  "success": true,
  "data": {
    "task_id": "task_abc123",
    "model": "veo3",
    "status": "completed",
    "output": { "video_url": "https://..." },
    "video_url": "https://...",
    "error_message": null,
    "credits_used": 130,
    "credits_refunded": 0,
    "created_at": "2026-10-04T10:00:00.000Z",
    "updated_at": "2026-10-04T10:01:12.000Z",
    "completed_at": "2026-10-04T10:01:12.000Z"
  },
  "request_id": "req_abc123"
}

Дождаться результата

TASK_ID=task_abc123
while true; do
  TASK=$(curl -s https://www.bananapro.site/api/v1/videos/$TASK_ID \
    -H "Authorization: Bearer sk-your-api-key")
  STATUS=$(echo "$TASK" | jq -r '.data.status')
  if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
    echo "$TASK" | jq
    break
  fi
  sleep 10
done

Цены

Model	Credits
veo3 (high quality)	130
veo3_fast (faster)	30

Особенности

Генерация видео из текста
Высококачественный результат
Несколько соотношений сторон
Удаление водяного знака (опционально)

curl -X POST https://www.bananapro.site/api/v1/videos/generate \ -H "Authorization: Bearer sk-your-api-key" \ -H "Content-Type: application/json" \ -d '{ "model": "veo3", "prompt": "A drone shot flying over a tropical beach at sunset", "aspect_ratio": "16:9" }'

{ "success": true, "data": { "task_id": "task_abc123", "model": "veo3", "status": "completed", "output": { "video_url": "https://..." }, "video_url": "https://...", "error_message": null, "credits_used": 130, "credits_refunded": 0, "created_at": "2026-10-04T10:00:00.000Z", "updated_at": "2026-10-04T10:01:12.000Z", "completed_at": "2026-10-04T10:01:12.000Z" }, "request_id": "req_abc123" }

TASK_ID=task_abc123 while true; do TASK=$(curl -s https://www.bananapro.site/api/v1/videos/$TASK_ID \ -H "Authorization: Bearer sk-your-api-key") STATUS=$(echo "$TASK" | jq -r '.data.status') if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then echo "$TASK" | jq break fi sleep 10 done

Model

Credits

veo3 (high quality)

130

veo3_fast (faster)