概述
Oxygen 是 AZ8 提供的影片生成模型。AZ8 是新加坡的 AI 影片創作平臺(前身為 Videoinu)。API易 以oxygen-1.0 提供該模型,介面相容 OpenAI Videos(POST /v1/videos 提交、GET /v1/videos/{id} 查詢),時長 4–15 秒,清晰度 480p / 768p,每秒 $0.02,不區分清晰度。
影片生成 API 參考
充值加贈活動
讓 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 …
- 端點:OpenAI Videos 格式。提交
POST https://api.apiyi.com/v1/videos(JSON) …
共 10 條接入要求,點下方按鈕複製完整版
這段提示詞替你擋掉了什麼
這段提示詞替你擋掉了什麼
為什麼選 API易 的 Oxygen
走量價格
失敗自動退款
OpenAI Videos 相容
/v1/videos 的提交、查詢寫法,已有 Sora 類接入程式碼改動很小充值加贈可疊加
影片模型生態齊全
全球零門檻接入
api.apiyi.com 直連,一個 API Key 即可呼叫,無需海外賬號核心特性
四種生成方式
兩檔清晰度
4–15 秒任意整數時長
自帶音軌
模型定價
- 按請求的
seconds計費,提交受理時預扣;成片實際長度會略長於請求值(4 秒約 4.5 秒),不額外收費 - 清晰度、畫幅、畫質檔(
quality)、提示詞增強(prompt_enhance)、參考素材都不影響價格 - 任務失敗(上游失敗、超時等)自動全額退款
- 提交階段返回 400 的請求不扣費;查詢和下載不收費
分組介紹
oxygen-1.0 在 default 預設分組即可呼叫,svip 分組同樣可用。令牌計費模式請用 按量優先(Pay-as-you-go Priority)。如果呼叫時報「當前分組沒有可用渠道」,說明令牌分組不含本模型,或 model 拼寫有誤。
技術規格
端點一覽
生成方式詳解
頂層欄位只有model、prompt、seconds、size、input_reference 五個會生效。首尾幀、參考素材、1:1、畫質檔這些高階引數統一寫進 input_reference 的 JSON 信封(一段以 { 開頭的 JSON 字串):
size 與清晰度的對應關係:
最佳實踐
先用 4 秒試效果
每次顯式寫 size
1280x720、豎屏 720x1280;要更清晰用 1792x1024 / 1024x1792(768p)首尾幀用比例相近的兩張圖
素材放在穩定的公網儲存
輪詢間隔 5 秒,整體 15 分鐘兜底
拿到 video_url 立即轉存
錯誤碼與重試
message 欄位裡,例如 {"message":"{\"error\":{\"code\":\"invalid_params\",...}}","type":"task_error"},解析時需要再 json.loads 一次。常見問題
為什麼我要的橫屏影片出來是豎屏?
為什麼我要的橫屏影片出來是豎屏?
size。不傳時閘道會預設補 720x1280(豎屏)。橫屏請顯式傳 1280x720 或 1792x1024。傳了 last_image / reference_images 為什麼沒效果?
傳了 last_image / reference_images 為什麼沒效果?
model、prompt、seconds、size、input_reference 會生效,其餘欄位會被靜默丟棄。請寫進 input_reference 的 JSON 信封,見上文「生成方式詳解」。還能選 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 控制模型是否改寫你的提示詞:refine 潤色擴寫、format 只規整格式、none 原樣使用。預設 high + refine,和 2026-10-14 之前的效果一致。想讓提示詞逐字生效時,在信封裡傳 "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 連結。圖生影片能指定畫幅嗎?
圖生影片能指定畫幅嗎?
aspect_ratio 會被忽略。清晰度仍可通過 size 或信封裡的 resolution 選擇。