ToAPIs

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

  • sora-2-pro 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.
Назад к рынку моделей

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

sora-2-pro

sora-2-pro 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

  • sora-2-pro 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.

sora-2-pro Возможности модели

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

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

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 sora-2-pro

  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 sora-2-pro?

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 sora-2-pro

Generate videos directly from prompts.

Mode Parameters

modelpromptaspect_ratiodurationresolution

Best Scenarios

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

Related APIs

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

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

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