跳轉到主要內容

概述

Oxygen 是 AZ8 提供的影片生成模型。AZ8 是新加坡的 AI 影片創作平臺(前身為 Videoinu)。API易 以 oxygen-1.0 提供該模型,介面相容 OpenAI Videos(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 示例與線上除錯

充值加贈活動

充值加贈疊加後,實際單價更低

讓 AI Agent 幫你接入

複製這段提示詞,貼上給 Codex / Claude Code / Cursor

它會先抓本頁的純文本版(任意文件頁地址後加 .md),再按你專案的技術棧寫程式碼。顯式傳 size、高階引數要寫進 input_reference 的 JSON 信封、時長只認 seconds 這幾個高頻坑已經寫死在要求裡。

幫我在當前專案裡接入 / 排查 Oxygen(oxygen-1.0)影片生成(文生影片 / 首幀 / 首尾幀 / 參考素材生影片)。

先讀文件再動手:抓 https://docs.apiyi.com/api-capabilities/oxygen/overview.md 拿到本頁純文本版;引數與程式碼示例在 htt …

  1. 端點:OpenAI Videos 格式。提交 POST https://api.apiyi.com/v1/videos(JSON) …

共 10 條接入要求,點下方按鈕複製完整版

為什麼選 API易 的 Oxygen

走量價格

$0.02/秒,不分清晰度;4 秒 $0.08,適合批量出片和 A/B 試稿

失敗自動退款

任務失敗全額退回,提交階段報錯不扣費,只為成功的影片付費

OpenAI Videos 相容

沿用 /v1/videos 的提交、查詢寫法,已有 Sora 類接入程式碼改動很小

充值加贈可疊加

疊加 充值加贈活動 後實際成本更低

影片模型生態齊全

同一個 Key 還能調 Seedance 2.0 / 2.5、MiniMax-H3、Wan2.7 等影片模型

全球零門檻接入

api.apiyi.com 直連,一個 API Key 即可呼叫,無需海外賬號

核心特性

四種生成方式

文生、首幀、首尾幀、參考圖 / 影片 / 音訊生影片,同一個端點

兩檔清晰度

480p / 768p,價格相同,按需選擇速度與畫質

4–15 秒任意整數時長

按請求秒數計費,短影片不浪費

自帶音軌

成片 MP4 自帶音訊軌,無需單獨配音

模型定價

模型價格可能調整;上表僅供參考,具體以頂部導航「模型價格」欄目為準:模型價格。
計費說明:
  • 按請求的 seconds 計費,提交受理時預扣;成片實際長度會略長於請求值(4 秒約 4.5 秒),不額外收費
  • 清晰度、畫幅、畫質檔(quality)、提示詞增強(prompt_enhance)、參考素材都不影響價格
  • 任務失敗(上游失敗、超時等)自動全額退款
  • 提交階段返回 400 的請求不扣費;查詢和下載不收費

分組介紹

oxygen-1.0 在 default 預設分組即可呼叫,svip 分組同樣可用。令牌計費模式請用 按量優先(Pay-as-you-go Priority)。如果呼叫時報「當前分組沒有可用渠道」,說明令牌分組不含本模型,或 model 拼寫有誤。

技術規格

端點一覽

主域名 https://api.apiyi.com,備用域名 https://b.apiyi.com,路徑相同。下載建議直接用查詢響應裡的 video_url。

生成方式詳解

頂層欄位只有 model、prompt、seconds、size、input_reference 五個會生效。首尾幀、參考素材、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 必須是字串:信封要先 JSON 序列化(Python 用 json.dumps,JS 用 JSON.stringify),直接傳物件或陣列會被拒

最佳實踐

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"},解析時需要再 json.loads 一次。

常見問題

沒傳 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)。兩檔清晰度同價。
一樣,都是 $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 都支援圖片 data URI(如 data:image/jpeg;base64,...)。參考影片和參考音訊只支援 https 連結。
不能,圖生影片的畫幅跟隨首幀圖片比例,aspect_ratio 會被忽略。清晰度仍可通過 size 或信封裡的 resolution 選擇。

相關文件