ToAPIs

Краткий вывод

  • Veo 3.1 supports Text-to-Video, Image-to-Video, R2V, and Video Edit in one workflow.
  • Use this model guide page to validate parameters with minimal request/response examples.
  • Stabilize prompts here first, then move to production API integration.

Ключевые параметры

  • model | string | обяз. | gemini_omni | - | Model identifier. Use the fixed value `gemini_omni`.
  • prompt | string | обяз. | - | - | Main instruction describing the subject, action, scene, and style.
  • aspect_ratio | string | опц. | 16:9 | 16:9 | 9:16 | Video aspect ratio. Defaults to `16:9`, corresponding to landscape or portrait output.
  • duration | integer | опц. | 6 | 6 | 10 | Output duration in seconds. Defaults to `6` and currently supports only `6` and `10`.
  • resolution | string | опц. | 720P | 720P | Output resolution. Currently only `720P` is supported; if omitted, the default value is used.

Частые ошибки

  • 400 invalid_request_error: триггер=Request payload misses required fields or has invalid field types.; исправление=Validate model, mode, and input schema before request.; повтор=Retry only after fixing payload; avoid blind retries.
  • 401 authentication_error: триггер=Missing Authorization header or invalid API key.; исправление=Verify Bearer token format and API key scope.; повтор=Retry after auth fix; rotate key if repeated failures continue.
  • 429 rate_limit_exceeded: триггер=Request rate, concurrency, or current quota hits upstream rate limiting.; исправление=Apply exponential backoff first, then review request rate, concurrency, and quota usage.; повтор=Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.
  • 500 internal_error: триггер=Transient upstream error or internal processing failure.; исправление=Capture request id and trigger retry workflow.; повтор=Retry 2-3 times with short delays; escalate if persistent.
Назад к рынку моделей

Разбор модели

Veo 3.1

Veo 3.1 is provided by ToAPIs with General capabilities. Current pricing reference: Pay-as-you-go pricing. This page helps you understand positioning, parameters, and production-ready use cases before integration.

Вендор

ToAPIs

Модальности

General

Цена

Pay-as-you-go pricing

Обновлено

-

Открыть в PlaygroundДокументация

Обзор модели

Quick Answer

  • Veo 3.1 supports Text-to-Video, Image-to-Video, R2V, and Video Edit in one workflow.
  • Use this model guide page to validate parameters with minimal request/response examples.
  • Stabilize prompts here first, then move to production API integration.

Veo 3.1 Возможности модели

Ключевой блок

Ключевые возможности и практическая ценность

Unified multi-mode testing

Switch across Text-to-Video, Image-to-Video, R2V, and Video Edit in one place.

Parameter-first validation

Iterate quickly on prompts, durations, and references before production rollout.

Production-ready handoff

Minimal request/response structure helps you move stable configs into API workflows.

Как использовать API Veo 3.1

  1. Fill prompt and key parameters.
  2. Run, inspect output structure, then iterate.
  3. Move stable settings into production API.

Key Parameters

ParameterTypeRequiredDefaultRangeDescription
modelstringYesgemini_omni-Model identifier. Use the fixed value `gemini_omni`.
promptstringYes--Main instruction describing the subject, action, scene, and style.
aspect_ratiostringNo16:916:9 | 9:16Video aspect ratio. Defaults to `16:9`, corresponding to landscape or portrait output.
durationintegerNo66 | 10Output duration in seconds. Defaults to `6` and currently supports only `6` and `10`.
resolutionstringNo720P720POutput resolution. Currently only `720P` is supported; if omitted, the default value is used.

Common Errors

400 invalid_request_error

Trigger: Request payload misses required fields or has invalid field types.

Fix: Validate model, mode, and input schema before request.

Retry: Retry only after fixing payload; avoid blind retries.

401 authentication_error

Trigger: Missing Authorization header or invalid API key.

Fix: Verify Bearer token format and API key scope.

Retry: Retry after auth fix; rotate key if repeated failures continue.

429 rate_limit_exceeded

Trigger: Request rate, concurrency, or current quota hits upstream rate limiting.

Fix: Apply exponential backoff first, then review request rate, concurrency, and quota usage.

Retry: Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.

500 internal_error

Trigger: Transient upstream error or internal processing failure.

Fix: Capture request id and trigger retry workflow.

Retry: Retry 2-3 times with short delays; escalate if persistent.

FAQ

When should I use Veo 3.1?

Use it to validate video concepts quickly, compare mode behavior, and converge prompts before API rollout.

How do I choose Text-to-Video vs Image-to-Video?

Use Text-to-Video when you only have instructions; use Image-to-Video when you already have key frames or composition.

What is the difference between R2V and Video Edit?

R2V focuses on reference-guided generation, while Video Edit focuses on modifying existing video assets.

Ошибка у модели изображений или видео: invalid apitype: -1

Обычно это означает, что запрос отправлен не в тот endpoint. Модели изображений и видео обычно не используют chat endpoint. Вместо этого нужно отправлять HTTP-запрос на создание задачи по документации и затем опрашивать endpoint статуса задачи. Сначала проверьте фактический код запроса, URL и payload.

Задача на генерацию изображения или видео завершилась ошибкой, но списание произошло

Сначала попросите у пользователя лог задачи или скриншот и проверьте, есть ли там статистика входных или выходных токенов. Если учет токенов есть, запрос, скорее всего, был отправлен через chat endpoint, а не через правильный media workflow. Модели изображений и видео обычно работают как асинхронные HTTP task API: сначала отправляется задача, затем выполняется опрос по task id согласно документации.

Mode Notes

Text to Video with Veo 3.1

Generate videos directly from prompts.

Mode Parameters

modelpromptaspect_ratiodurationresolution

Best Scenarios

  • Ad storyboard preview
  • Shot draft generation
  • Social content prototyping

Related APIs

Готовы начать?

Зарегистрируйтесь бесплатно и испытайте мощь корпоративного API-шлюза для ИИ

Начать бесплатноПосмотреть цены