Генерация видео Oxygen

Обзор

Oxygen — это модель генерации видео, предоставляемая AZ8, сингапурской платформой для создания ИИ-видео (ранее Videoinu). APIYI предоставляет её как oxygen-1.0 через API, совместимый с OpenAI Videos (POST /v1/videos для отправки, GET /v1/videos/{id} для запроса статуса), с клипами продолжительностью от 4 до 15 секунд в разрешениях 320p / 480p / 768p, с тарификацией $0.02 за секунду независимо от разрешения.

Ключевые особенности: одна модель охватывает генерацию видео по тексту (text-to-video), по первому кадру, по первому и последнему кадрам, а также генерацию по референсам (до 9 изображений, 3 видео и 3 аудиоклипов). Результат сопровождается звуковой дорожкой. $0.02 за секунду: 5-секундный клип стоит $0.10, а 15-секундный — $0.30, при этом средства за неудачные задачи возвращаются автоматически. Создано для масштабной и недорогой генерации видео.

Справочник по API генерации видео

Отправка, опрос статуса и скачивание с примерами на Python / cURL / Node.js и интерактивным Playground

Бонусы за пополнение

Бонусы за пополнение делают фактическую цену ещё ниже

Пусть AI-агент выполнит интеграцию за вас

Если вы разрабатываете с помощью Codex / Claude Code / Cursor, скопируйте приведенный ниже prompt в него. Агент сначала получит текстовую версию этой страницы (добавьте .md к любому URL документации), а затем напишет код под ваш стек. Типичные ошибки уже учтены: всегда передавайте size, помещайте расширенные параметры в JSON-конверт input_reference и задавайте длительность только через seconds.

Поручите агенту написания кода интеграцию или отладку генерации видео с помощью Oxygen (oxygen-1.0). Скопируйте и вставьте это в Codex, Claude Code, Cursor и т. д.

От чего защищает этот prompt

Требование	Ошибка, которую оно предотвращает
Всегда передавать `size`	Без этого шлюз по умолчанию использует вертикальный размер, поэтому запрос на горизонтальное видео вернет вертикальный результат
Расширенные параметры в конверте `input_reference`	`last_image`, `reference_images` или `resolution` на верхнем уровне молча отбрасываются без ошибок: последний кадр игнорируется, референсы игнорируются, а разрешение устанавливается неверно
Длительность только через `seconds`	`duration` внутри конверта отклоняется; и тарификация, и длительность ролика зависят от `seconds`
Скачивать `video_url`	Вызов `/content` сразу после того, как статус стал `completed`, может вернуть 400 и выглядеть как сбой
Сразу копировать файл	Ссылка становится недействительной примерно через 24 часа

Почему Oxygen от APIYI?

Оптовые цены

$0.02 за секунду при любом разрешении; $0.08 за 4 секунды — отлично подходит для пакетной генерации и A/B-черновиков

Автоматический возврат средств

За неудачные задачи средства возвращаются в полном объеме, а отклоненные запросы бесплатны, поэтому вы платите только за полученные видео

Совместимость с OpenAI Videos

Тот же паттерн отправки и опроса, что и в /v1/videos, поэтому существующий код в стиле Sora потребует минимум изменений

Суммирование бонусов за пополнение

Сочетайте с бонусами за пополнение для снижения фактической стоимости

Полная линейка видеомоделей

Один и тот же ключ позволяет вызывать Seedance 2.0 / 2.5, MiniMax-H3, Wan2.7 и другие

Глобальный доступ

Подключайтесь напрямую к api.apiyi.com с помощью одного API-ключа без необходимости зарубежного аккаунта

Ключевые возможности

Четыре режима генерации

Текст, первый кадр, первый и последний кадры, а также референсные изображение / видео / аудио — все в одном эндпоинте

Три разрешения

320p / 480p / 768p по одной цене; выбирайте между скоростью и детализацией по необходимости

Любая целая длительность от 4 до 15 с

Тарификация за запрошенные секунды, поэтому короткие клипы стоят дешевле

Встроенное аудио

Итоговый MP4 содержит аудиодорожку, отдельное озвучивание не требуется

Тарифы

Позиция	Цена
Выходное видео (320p / 480p / 768p, одинаковая цена)	$0.02 / секунда
Первый кадр, последний кадр, референсное изображение / видео / аудио	Без дополнительной платы
Пример: 4-секундный ролик	$0.08
Пример: 15-секундный ролик	$0.30

Цены могут меняться; таблица выше приведена только для справки, а вкладка Тарифы моделей в верхнем меню навигации является приоритетной: Тарифы моделей.

Примечания по тарификации:

Тарификация осуществляется по запрошенной seconds, средства списываются при принятии задачи; фактический ролик длится немного дольше (около 4,5 с при запросе на 4 с) без дополнительной платы
Разрешение, соотношение сторон и референсные медиафайлы не влияют на цену
Задачи с ошибками (сбой провайдера, таймаут и т. д.) автоматически возвращаются в полном объеме
Отправка запросов, вернувших статус 400, не тарифицируется; проверка статуса и скачивание бесплатны

Настройка группы

oxygen-1.0 работает в группе default, также подходит группа svip. Установите режим тарификации token на Pay-as-you-go Priority. Если при вызове возвращается «no available channel in the current group», значит, в группе token нет этой модели либо имя model указано с ошибкой.

Параметр	Требование
Группа	`default` или `svip`
Режим тарификации	Pay-as-you-go Priority
Название модели	`oxygen-1.0` (суффикс `-1.0` обязателен)

Технические характеристики

Параметр	Спецификация
ID модели	`oxygen-1.0`
Длительность	Целое число от 4 до 15 секунд (на верхнем уровне `seconds`)
Разрешение	320p / 480p (по умолчанию) / 768p
Соотношение сторон	Горизонтальное 16:9, вертикальное 9:16, квадратное 1:1; в режиме image-to-video наследуется от первого кадра
Выходной размер (фактический)	320p: 576×320; 480p: 864×480 / 480×864 / 480×480; 768p: 1344×768 / 768×1344 / 768×768
Аудио	Результат содержит аудиодорожку
Входное изображение	Публичный https URL или data URI изображения
Референсные медиафайлы	Изображения до 9, видео до 3, аудио до 3 (видео и аудио только в виде https URL)
Результат	MP4 через `video_url` в ответе на запрос, действует около 24 часов
Время генерации	Обычно 1–3 минуты; от 5 минут при высокой загрузке очереди

Эндпоинты API

Назначение	Метод	Путь
Создание задачи	`POST`	`/v1/videos`
Запрос задачи	`GET`	`/v1/videos/{id}`
Скачивание (необязательно)	`GET`	`/v1/videos/{id}/content`

Основной домен — https://api.apiyi.com, резервный домен — https://b.apiyi.com, пути те же. Для скачивания используйте video_url напрямую из ответа на запрос.

Режимы генерации

Действуют только пять полей верхнего уровня: model, prompt, seconds, size и input_reference. Первый и последний кадры, референсные медиафайлы, 320p и 1:1 — это расширенные параметры, которые помещаются в JSON-оболочку input_reference (строку JSON, начинающуюся с {):

Режим	Способ указания	Разрешение / соотношение сторон
Видео по тексту	Опустите `input_reference`	Задается через `size`
Видео по первому кадру	`input_reference` = URL изображения или data URI	Разрешение из `size`, соотношение сторон наследуется от первого кадра
Видео по первому и последнему кадрам	Оболочка `{"images":["first"],"last_image":"last"}`	То же, что и выше
Видео по референсным медиафайлам	Оболочка `{"reference_images":[...],"reference_videos":[...],"reference_audios":[...]}`	Задается через `size`; `aspect_ratio` можно передать в оболочке
320p или 1:1	Оболочка `{"resolution":"320p","aspect_ratio":"1:1"}` (можно сочетать с любым режимом выше)	Оболочка имеет приоритет над `size`

Как size сопоставляется с разрешением:

`size`	Разрешение	Ориентация
`1280x720`	480p	Альбомная 16:9
`720x1280`	480p	Портретная 9:16
`1792x1024`	768p	Альбомная 16:9
`1024x1792`	768p	Портретная 9:16

Пример оболочки (первый и последний кадр):

{
  "model": "oxygen-1.0",
  "prompt": "The glass sphere slowly dissolves into a deep blue abstract wave",
  "seconds": "5",
  "size": "1280x720",
  "input_reference": "{\"images\":[\"https://your-cdn.example.com/first.png\"],\"last_image\":\"https://your-cdn.example.com/last.png\"}"
}

last_image, reference_images, resolution, aspect_ratio и аналогичные поля незаметно игнорируются при размещении на верхнем уровне: ошибка не возникает, тарификация списывается в обычном режиме, но последний кадр и референсы игнорируются, а разрешение определяется полем size. Всегда передавайте их в оболочке input_reference
Поле duration не допускается в оболочке; используйте seconds на верхнем уровне. Некорректный JSON или ошибки в написании ключей возвращают код 400 (param: input_reference) без списания средств
Первый и последний кадры нельзя комбинировать с референсными медиафайлами
Поле input_reference должно быть строкой: сначала сериализуйте оболочку (json.dumps в Python, JSON.stringify в JS). Передача объекта или массива напрямую отклоняется

Коды ошибок и повторные попытки

Этап	Симптом	Причина	Решение
Отправка	400, `invalid_params`, `param: input.duration`	`seconds` вне диапазона 4–15	Измените длительность; средства не списаны
Отправка	400, `invalid_params`, `param: input_reference`	Некорректный JSON envelope, неизвестный ключ или `duration` в envelope	Исправьте envelope согласно сообщению; средства не списаны
Отправка	400, `cannot unmarshal array ... input_reference`	`input_reference` передан как массив или объект вместо строки	Сериализуйте его с помощью `json.dumps` / `JSON.stringify`
Отправка	500, сбой загрузки референсного файла	URL изображения в `input_reference` недоступен	Используйте общедоступный URL по протоколу https
Отправка	503, нет доступного канала	Группа token не включает данную модель или в названии модели допущена ошибка	Проверьте группу и `oxygen-1.0`
Выполнение	`failed`, `upstream_error`	Периодический сбой на стороне провайдера	Отправьте запрос повторно через несколько минут (средства уже возвращены)
Выполнение	`failed`, `upstream_timeout`	Слишком долгое нахождение в очереди на стороне upstream, превышен лимит времени	Отправьте запрос повторно позже (средства уже возвращены)

Подробная информация об ошибке передается в виде строки JSON внутри поля message ответа, например {"message":"{\"error\":{\"code\":\"invalid_params\",...}}","type":"task_error"}, поэтому выполните парсинг повторно.

Часто задаваемые вопросы

Почему моё горизонтальное видео получилось вертикальным?

Параметр size не был передан. Без него шлюз по умолчанию использует 720x1280 (вертикальный формат). Для горизонтального видео явно укажите 1280x720 или 1792x1024.

Почему last_image / reference_images не действуют?

Они были указаны на верхнем уровне запроса. Там действуют только model, prompt, seconds, size и input_reference; всё остальное отбрасывается без предупреждения. Поместите их в JSON-оболочку input_reference, см. раздел «Режимы генерации» выше.

Как получить 320p? Передача resolution ничего не даёт.

Параметр resolution на верхнем уровне отбрасывается. Поместите его в оболочку: "input_reference": "{\"resolution\":\"320p\"}". Все три разрешения стоят одинаково.

Отличается ли стоимость для разных разрешений?

Нет, для всех действует тариф $0.02 за секунду. 320p рендерится быстрее и даёт файлы меньшего размера; 768p обеспечивает более высокую чёткость.

Статус указывает completed, но /content возвращает 400?

Сразу после того как статус становится completed, для /v1/videos/{id}/content может потребоваться ещё несколько секунд. Вместо этого используйте video_url из ответа на запрос.

Сколько действует ссылка на видео?

Около 24 часов (см. expires_at в ответе на запрос). Своевременно скачайте и сохраните файл.

Списываются ли средства за неудачные задачи?

Нет. За задачу со статусом failed средства автоматически возвращаются в полном объёме, а за отправку запросов, возвращающих 400, плата не взимается.

Что делать при периодической ошибке upstream_error?

Это единичный сбой на стороне провайдера, средства за него уже возвращены. Повторная отправка через несколько минут обычно решает проблему.

Почему ролик немного длиннее, чем указано в секундах?

Итоговое видео длится чуть дольше (около 4.5 с для 4 с, 5.2 с для 5 с). Тарификация рассчитывается по запрошенному значению seconds, поэтому дополнительная плата не взимается.

Может ли первый кадр быть в base64?

Да. Параметры input_reference и images в оболочке принимают data URI изображений (например, data:image/jpeg;base64,...). Опорные видео и аудио принимают только https URL.

Можно ли задать соотношение сторон для генерации видео по изображению?

Нет. В режиме генерации видео по изображению сохраняется соотношение сторон первого кадра, а aspect_ratio игнорируется. Вы по-прежнему можете выбрать разрешение с помощью size или resolution в оболочке.

Основы

Базовый API

Image API (официальный)

Video API (официальный)

API мультимодального понимания

Генерация текста

Audio API (официальный)

Поиск и безопасность

Генерация видео Oxygen

Обзор

Справочник по API генерации видео

Бонусы за пополнение

Пусть AI-агент выполнит интеграцию за вас

Почему Oxygen от APIYI?

Оптовые цены

Автоматический возврат средств

Совместимость с OpenAI Videos

Суммирование бонусов за пополнение

Полная линейка видеомоделей

Глобальный доступ

Ключевые возможности

Четыре режима генерации

Три разрешения

Любая целая длительность от 4 до 15 с

Встроенное аудио

Тарифы

Настройка группы

Технические характеристики

Эндпоинты API

Режимы генерации

Рекомендации

Коды ошибок и повторные попытки

Часто задаваемые вопросы

Связанная документация

​Обзор

Справочник по API генерации видео

Бонусы за пополнение

​Пусть AI-агент выполнит интеграцию за вас

​Почему Oxygen от APIYI?

Оптовые цены

Автоматический возврат средств

Совместимость с OpenAI Videos

Суммирование бонусов за пополнение

Полная линейка видеомоделей

Глобальный доступ

​Ключевые возможности

Четыре режима генерации

Три разрешения

Любая целая длительность от 4 до 15 с

Встроенное аудио

​Тарифы

​Настройка группы

​Технические характеристики

​Эндпоинты API

​Режимы генерации

​Рекомендации

​Коды ошибок и повторные попытки

​Часто задаваемые вопросы

​Связанная документация

Обзор

Пусть AI-агент выполнит интеграцию за вас

Почему Oxygen от APIYI?

Ключевые возможности

Тарифы

Настройка группы

Технические характеристики

Эндпоинты API

Режимы генерации

Рекомендации

Коды ошибок и повторные попытки

Часто задаваемые вопросы

Связанная документация