Обзор
Oxygen — это модель генерации видео, предоставляемая AZ8, сингапурской платформой для создания ИИ-видео (ранее Videoinu). APIYI предоставляет её какoxygen-1.0 через API, совместимый с видео OpenAI (POST /v1/videos для отправки, GET /v1/videos/{id} для запроса), с длительностью клипов от 4 до 15 секунд в разрешении 480p / 768p и тарификацией $0.02 за секунду независимо от разрешения.
Справочник по API генерации видео
Бонусы за пополнение
Доверьте интеграцию 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. …
- Эндпоинты: формат OpenAI Videos. Отправляйте через
POST https://api.apiyi.com/v1/videos(JSON), запрашивайте черезGET https://api.apiyi.com/v1/videos/{id}. Отправ…
Всего 10 требований. Используйте кнопку ниже, чтобы скопировать полный prompt.
От каких ошибок защищает этот prompt
От каких ошибок защищает этот prompt
Почему Oxygen от APIYI?
Оптовые цены
Автоматический возврат средств
Совместимость с OpenAI Videos
/v1/videos, поэтому существующий код в стиле Sora потребует минимум измененийСуммирование бонусов за пополнение
Полная линейка видеомоделей
Глобальный доступ
api.apiyi.com с помощью одного API-ключа без необходимости зарубежного аккаунтаКлючевые возможности
Четыре режима генерации
Два разрешения
Любая целая длительность от 4 до 15 с
Встроенное аудио
Цены
- Тарификация рассчитывается по запрошенной
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
Режимы генерации
Действуют только пять полей верхнего уровня:model, prompt, seconds, size и input_reference. Первый и последний кадры, референсные медиафайлы, 1:1 и уровень качества — это расширенные параметры, которые помещаются в JSON-оболочку input_reference (строка JSON, начинающаяся с {):
size сопоставляется с разрешением:
Рекомендации
Сначала тестируйте на 4 секундах
Всегда указывайте size
1280x720, портретная — 720x1280; для более высокой детализации используйте 1792x1024 / 1024x1792 (768p)Используйте первый и последний кадры с близким соотношением сторон
Размещайте медиафайлы в надежном публичном хранилище
Опрашивайте каждые 5 секунд с таймаутом 15 минут
Сразу сохраняйте video_url в собственное хранилище
Коды ошибок и повторные попытки
message, например {"message":"{\"error\":{\"code\":\"invalid_params\",...}}","type":"task_error"}, поэтому выполните парсинг повторно.Часто задаваемые вопросы
Почему горизонтальное видео получилось вертикальным?
Почему горизонтальное видео получилось вертикальным?
size не был передан. Без него шлюз по умолчанию использует 720x1280 (вертикальный). Для горизонтальной ориентации явно укажите 1280x720 или 1792x1024.Почему last_image / reference_images не действуют?
Почему last_image / reference_images не действуют?
model, prompt, seconds, size и input_reference; все остальные параметры игнорируются без уведомления. Поместите их в JSON-конверт input_reference, см. раздел «Режимы генерации» выше.Можно ли по-прежнему использовать 320p?
Можно ли по-прежнему использовать 320p?
"resolution":"320p" в конверте возвращает ошибку 400 при отправке (must be one of 480p/768p) и не тарифицируется. Вместо этого используйте 480p.Передача resolution ни на что не влияет?
Передача resolution ни на что не влияет?
resolution на верхнем уровне игнорируется. Поместите его в конверт: "input_reference": "{\"resolution\":\"768p\"}" или выберите с помощью size (1792x1024 / 1024x1792 = 768p). Стоимость обоих разрешений одинакова.Отличается ли стоимость для разных разрешений?
Отличается ли стоимость для разных разрешений?
Что такое quality и prompt_enhance? Нужны ли они?
Что такое quality и prompt_enhance? Нужны ли они?
quality — это уровень качества (high / normal); prompt_enhance определяет, переписывает ли модель ваш prompt: refine улучшает и расширяет его, format только упорядочивает форматирование, none использует его как есть. Значения по умолчанию, high + refine, соответствуют поведению до 2026-10-14. Чтобы ваш prompt использовался дословно, передайте "prompt_enhance":"none" в конверте. Ни один из параметров не влияет на стоимость.Статус указывает completed, но /content возвращает 400?
Статус указывает completed, но /content возвращает 400?
completed, для /v1/videos/{id}/content может потребоваться еще несколько секунд. Вместо этого используйте video_url из ответа на запрос.Сколько времени действует ссылка на видео?
Сколько времени действует ссылка на видео?
expires_at в ответе на запрос). Своевременно скачайте и сохраните его.Списывается ли плата за неудачные задачи?
Списывается ли плата за неудачные задачи?
failed, средства автоматически возвращаются в полном объеме, а отправленные запросы, вернувшие 400, не тарифицируются.Что делать при периодической ошибке upstream_error?
Что делать при периодической ошибке upstream_error?
Почему ролик немного длиннее, чем seconds?
Почему ролик немного длиннее, чем seconds?
seconds, поэтому дополнительная плата не взимается.Может ли первый кадр быть в base64?
Может ли первый кадр быть в base64?
input_reference, и images в конверте принимают data URI изображений (например, data:image/jpeg;base64,...). Опорные видео и аудио принимают только https URL.Можно ли задать соотношение сторон для генерации видео по изображению?
Можно ли задать соотношение сторон для генерации видео по изображению?
aspect_ratio. Вы по-прежнему можете выбрать разрешение с помощью size или resolution в конверте.