Перейти к основному содержанию

Обзор

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

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

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

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

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

Доверьте интеграцию AI-агенту

Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor

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

Интегрируйте или отладьте генерацию видео Oxygen (oxygen-1.0) в этом проекте (text-to-video / первый кадр / первый и последний кадры / референсные медиафайлы).

Прочитайте документацию перед написанием кода: загрузите https://docs.apiyi.com/en/api-capabilities/oxygen/overview.md для текстовой версии этой страницы; параметры и примеры кода находятся по адресу https://docs.apiyi. …

  1. Эндпоинты: формат OpenAI Videos. Отправляйте через POST https://api.apiyi.com/v1/videos (JSON), запрашивайте через GET https://api.apiyi.com/v1/videos/{id}. Отправ…

Всего 10 требований. Используйте кнопку ниже, чтобы скопировать полный prompt.

Почему 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-ключа без необходимости зарубежного аккаунта

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

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

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

Два разрешения

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

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

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

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

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

Цены

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

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

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

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

Эндпоинты API

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

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

Действуют только пять полей верхнего уровня: model, prompt, seconds, size и input_reference. Первый и последний кадры, референсные медиафайлы, 1:1 и уровень качества — это расширенные параметры, которые помещаются в JSON-оболочку input_reference (строка JSON, начинающаяся с {): Как size сопоставляется с разрешением: Пример оболочки (первый и последний кадры):
  • Поля 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). Передача объекта или массива напрямую будет отклонена

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

1

Сначала тестируйте на 4 секундах

Тарификация посекундная, поэтому сначала проверьте композицию и стиль на 4 секундах, прежде чем запускать рендеринг финальных версий на 10–15 секунд
2

Всегда указывайте size

Альбомная ориентация — 1280x720, портретная — 720x1280; для более высокой детализации используйте 1792x1024 / 1024x1792 (768p)
3

Используйте первый и последний кадры с близким соотношением сторон

Итоговое видео сохраняет соотношение сторон первого кадра; если последний кадр сильно отличается по пропорциям, он будет обрезан во время перехода
4

Размещайте медиафайлы в надежном публичном хранилище

Используйте прямые ссылки с собственных OSS / CDN, чтобы избежать сбоев при скачивании из-за защиты от хотлинкинга или истекшего срока действия подписей
5

Опрашивайте каждые 5 секунд с таймаутом 15 минут

Большинство видео генерируются за 1–3 минуты; в периоды пиковой нагрузки это может занять больше времени
6

Сразу сохраняйте video_url в собственное хранилище

Срок действия ссылки истекает примерно через 24 часа; скачайте файл и раздавайте его из своего хранилища

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

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

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

Параметр size не был передан. Без него шлюз по умолчанию использует 720x1280 (вертикальный). Для горизонтальной ориентации явно укажите 1280x720 или 1792x1024.
Они были указаны на верхнем уровне запроса. Там действуют только model, prompt, seconds, size и input_reference; все остальные параметры игнорируются без уведомления. Поместите их в JSON-конверт input_reference, см. раздел «Режимы генерации» выше.
Нет. AZ8 прекратил поддержку уровня 320p 2026-10-14. Отправка "resolution":"320p" в конверте возвращает ошибку 400 при отправке (must be one of 480p/768p) и не тарифицируется. Вместо этого используйте 480p.
Параметр resolution на верхнем уровне игнорируется. Поместите его в конверт: "input_reference": "{\"resolution\":\"768p\"}" или выберите с помощью size (1792x1024 / 1024x1792 = 768p). Стоимость обоих разрешений одинакова.
Нет, оба стоят $0.02 за секунду. 480p рендерится быстрее и имеет меньший размер файлов; 768p обеспечивает более высокую четкость.
Обычно нет. quality — это уровень качества (high / normal); prompt_enhance определяет, переписывает ли модель ваш prompt: refine улучшает и расширяет его, format только упорядочивает форматирование, none использует его как есть. Значения по умолчанию, high + refine, соответствуют поведению до 2026-10-14. Чтобы ваш prompt использовался дословно, передайте "prompt_enhance":"none" в конверте. Ни один из параметров не влияет на стоимость.
Сразу после того, как статус изменится на completed, для /v1/videos/{id}/content может потребоваться еще несколько секунд. Вместо этого используйте video_url из ответа на запрос.
Около 24 часов (см. expires_at в ответе на запрос). Своевременно скачайте и сохраните его.
Нет. За задачу, завершившуюся статусом failed, средства автоматически возвращаются в полном объеме, а отправленные запросы, вернувшие 400, не тарифицируются.
Это периодический сбой на стороне провайдера, и средства за него уже возвращены. Повторная отправка через несколько минут обычно решает проблему.
Результирующее видео длится немного дольше (около 4,5 с для 4 с, 5,2 с для 5 с). Тарификация рассчитывается на основе запрошенного seconds, поэтому дополнительная плата не взимается.
Да. И input_reference, и images в конверте принимают data URI изображений (например, data:image/jpeg;base64,...). Опорные видео и аудио принимают только https URL.
Нет. Режим генерации видео по изображению наследует соотношение сторон первого кадра и игнорирует aspect_ratio. Вы по-прежнему можете выбрать разрешение с помощью size или resolution в конверте.

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