メインコンテンツへスキップ

概要

Oxygenは、シンガポールを拠点とするAI動画作成プラットフォームAZ8(旧Videoinu)が提供する動画生成モデルです。APIYIではこれをoxygen-1.0として、OpenAI Videos互換API(送信にはPOST /v1/videos、クエリにはGET /v1/videos/{id})を通じて提供しており、480p / 768pの4〜15秒のクリップを生成可能で、解像度に関わらず1秒あたり$0.02で課金されます。
ハイライト:1つのモデルでテキストからの動画生成、先頭フレーム動画、先頭および最終フレーム動画、最大9枚の画像、3本の動画、3つの音声クリップによるリファレンス生成をカバーします。出力にはオーディオトラックが含まれます。1秒あたり$0.02:5秒のクリップは$0.10、15秒のクリップは$0.30で、失敗したタスクは自動的に返金されます。大量かつ低コストな動画生成向けに構築されています。

動画生成APIリファレンス

Python / cURL / Node.jsのコード例とライブPlaygroundによる送信、ポーリング、ダウンロード

チャージボーナス

チャージボーナスにより、実質価格をさらに引き下げることができます

AIエージェントに統合を任せる

この prompt をコピーして Codex / Claude Code / Cursor に貼り付けてください

エージェントはまずこのページのプレーンテキスト版を取得し(任意のドキュメント URL に .md を追加)、お使いの技術スタック向けのコードを作成します。よくあるミスはすでに明記されています:必ず size を渡すこと、高度なパラメータは input_reference JSON エンベロープ内に配置すること、そして長さは seconds のみで設定することです。

Integrate or debug Oxygen (oxygen-1.0) video generation in this project (text-to-video / first frame / first and last frame / reference media).

Read the docs before writing code: fetch https://docs.apiyi.com/en/api-capabilities/oxygen/overview.md for the plain-text version of this page; parameters and code samples are at https://docs.apiyi. …

  1. Endpoints: OpenAI Videos format. Submit with POST https://api.apiyi.com/v1/videos (JSON), query with GET https://api.apiyi.com/v1/videos/{id}. Subm …

合計10件の要件があります。以下のボタンを使用して完全な prompt をコピーしてください。

なぜAPIYIのOxygenなのか?

ボリューム価格

解像度を問わず1秒あたり$0.02、4秒で$0.08。バッチ出力やA/Bテストのドラフト作成に最適です

自動返金

失敗したタスクは全額返金され、拒絶されたリクエストは無料となるため、実際に生成できた動画に対してのみ課金されます

OpenAI Videos互換

/v1/videosと同じ送信・照会パターンを採用しているため、既存のSoraスタイルのコードにほとんど変更を加える必要がありません

チャージボーナスの併用が可能

チャージボーナスと組み合わせることで、実質コストをさらに抑えられます

充実した動画モデルラインナップ

同じキーでSeedance 2.0 / 2.5、MiniMax-H3、Wan2.7なども呼び出し可能です

グローバルアクセス

1つのAPIキーでapi.apiyi.comに直接接続でき、海外アカウントを用意する必要はありません

主な機能

4つの生成モード

テキスト、最初のフレーム、最初と最後のフレーム、参照画像/動画/音声をすべて1つのエンドポイントで利用可能

2つの解像度

480p / 768pを同一価格で提供。必要に応じて速度と精細度を柔軟に調整可能

4〜15秒の任意の整数秒数

リクエストした秒数に応じて課金されるため、短いクリップならコストを抑えられます

オーディオ内蔵

出力されるMP4にオーディオトラックが含まれているため、個別のダビング作業は不要

料金

料金は変更される可能性があります。上記の表は参考用であり、トップナビゲーションのモデル料金タブの内容が正式な情報となります:モデル料金。
課金に関する注意事項:
  • リクエストされたsecondsに基づいて課金され、タスクが受理された時点で請求されます。実際のクリップはわずかに長くなりますが(4秒のリクエストで約4.5秒)、追加料金はかかりません
  • 解像度、アスペクト比、品質ティア(quality)、プロンプト拡張(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 の5つのみです。最初と最後のフレーム、参照メディア、1:1、品質ティアは、input_reference JSON エンベロープ({ で始まる JSON 文字列)に含める高度なパラメータです。 size が解像度にどのようにマッピングされるか: エンベロープの例(最初と最後のフレーム):
  • last_image、reference_images、resolution、aspect_ratio、および類似のフィールドは、トップレベルに配置された場合、警告なく破棄されます。エラーは発生せず通常の課金が行われますが、最後のフレームは無視され、参照も無視され、解像度は size に従います。必ず input_reference エンベロープ内に配置してください
  • エンベロープ内に duration を含めることはできません。トップレベルの seconds を使用してください。無効な JSON やキーのスペルミスは課金なしで 400(param: input_reference)を返します
  • 最初/最後のフレームを参照メディアと混在させることはできません
  • input_reference は文字列である必要があります。最初にエンベロープをシリアライズしてください(Python では json.dumps、JS では JSON.stringify)。オブジェクトや配列を直接渡すと拒否されます

ベストプラクティス

1

まずは4秒でテストする

課金は秒単位で行われるため、10〜15秒の最終動画をレンダリングする前に、まずは4秒で構図やスタイルを確認してください
2

必ずsizeを設定する

横向きは1280x720、縦向きは720x1280。より詳細な描写には1792x1024 / 1024x1792(768p)を使用します
3

最初と最後のフレームには近いアスペクト比を使用する

出力は最初のフレームのアスペクト比に従います。最後のフレームの比率が大きく異なると、遷移時にトリミングされます
4

メディアは安定したパブリックストレージにホストする

直リンク防止(ホットリンク保護)や署名の有効期限切れによってダウンロードが失敗するのを防ぐため、独自のOSS / CDN直リンクを使用してください
5

15分のタイムアウトを設定し、5秒ごとにポーリングする

ほとんどのクリップは1〜3分で完了しますが、ピーク時にはさらに時間がかかる場合があります
6

video_urlをすぐに自身のストレージにコピーする

リンクは約24時間で期限切れになります。ダウンロードしてご自身のストレージから配信してください

エラーコードとリトライ

エラーの詳細はレスポンスの message フィールド内の JSON 文字列(例:{"message":"{\"error\":{\"code\":\"invalid_params\",...}}","type":"task_error"})になっているため、再度パースしてください。

FAQ

size が渡されていませんでした。指定がない場合、ゲートウェイはデフォルトで 720x1280(縦向き)になります。横向きにするには、1280x720 または 1792x1024 を明示的に渡してください。
リクエストのトップレベルに配置されているためです。トップレベルで有効なのは model、prompt、seconds、size、および input_reference のみで、それ以外は暗黙的に破棄されます。これらは input_reference の JSON エンベロープ内に配置してください。上記の「生成モード」を参照してください。
いいえ、利用できません。AZ8 は 2026-10-14 に 320p ティアを廃止しました。エンベロープ内で "resolution":"320p" を送信すると、リクエスト送信時に 400(must be one of 480p/768p)が返され、課金は発生しません。代わりに 480p を使用してください。
トップレベルの resolution は無視されます。エンベロープ内("input_reference": "{\"resolution\":\"768p\"}")に配置するか、size で選択してください(1792x1024 / 1024x1792 = 768p)。どちらの解像度でも料金は同じです。
いいえ、どちらも 1 秒あたり $0.02 です。480p はファイルサイズが小さくレンダリングが高速で、768p はより高精細です。
通常は必要ありません。quality は品質ティア(high / normal)です。prompt_enhance はモデルがプロンプトをリライトするかどうかを制御します。refine はプロンプトを推敲・拡張し、format はフォーマットの整理のみを行い、none は記述されたとおりにそのまま使用します。デフォルト設定の high + refine は、2026-10-14 以前の動作と同じです。プロンプトを一語一句そのまま適用したい場合は、エンベロープ内で "prompt_enhance":"none" を送信してください。どちらのパラメータも料金には影響しません。
ステータスが completed に変わった直後は、/v1/videos/{id}/content の準備にさらに数秒かかる場合があります。代わりにクエリレスポンスの video_url を使用してください。
約 24 時間です(クエリレスポンス内の expires_at を参照してください)。速やかにダウンロードして保存してください。
いいえ、課金されません。failed で終了したタスクは自動的に全額返金され、400 が返されたリクエスト送信には課金されません。
プロバイダー側で一時的に発生した障害であり、すでに返金されています。数分後に再送信すれば、通常は正常に処理されます。
出力動画はわずかに長くなります(4 秒の場合は約 4.5 秒、5 秒の場合は約 5.2 秒)。課金にはリクエストされた seconds が使用されるため、追加料金は発生しません。
はい、使用できます。エンベロープ内の input_reference と images の両方で画像データ URI(data:image/jpeg;base64,... など)を受け付けます。参照動画および参照音声は https URL のみ受け付けます。
いいえ、設定できません。画像から動画への生成では先頭フレームのアスペクト比に従うため、aspect_ratio は無視されます。ただし、エンベロープ内の size または resolution から解像度を選択することは可能です。

関連ドキュメント