兩位開發者今早閱讀了 PixVerse 文件。一位推出了負面提示詞功能；另一位則發現那個參數早已不存在。
兩人讀的都是官方頁面。這就是 2026 年 PixVerse API 的真實狀態：一個功能強大、快速迭代的影片生成服務，而它的文件裡，舊頁面與新頁面正悄悄互相矛盾。大多數 PixVerse AI API 開發者的問題都歸結為兩件事：哪些文件是真正最新的？以及，程式碼寫好後，一段影片要花多少錢？
本指南兩者都回答。以下每一個端點、參數和價格，都是在 2026 年 7 月 23 日這一週，與第一方頁面核對過的。
關鍵要點
- PixVerse 官方 API 文件位於 docs.platform.pixverse.ai。API 金鑰與點數則在 platform.pixverse.ai。消費者應用程式 app.pixverse.ai 是另一個產品，計費方式也獨立。
- 每次呼叫都需要兩個標頭：API-KEY 加上每個請求獨一無二的 UUID（Ai-trace-id）。生成是非同步的：提交請求，取得 video_id，然後輪詢結果。
- 文件本身有些地方互相矛盾。較舊的教學頁面仍顯示 negative_prompt 和 water_mark；目前的生成參考文件則兩者都沒有。當頁面不一致時，請以端點參考文件為準。
- 官方計費以點數為單位（10 美元買 1,000 點）。同樣的 V6 模型在 Atlas Cloud 上按秒計費，每 0.025 美元起；預設的 5 秒 720p 含音訊片段，依秒計費為 0.30 美元，而套裝點數方案則為 0.60 美元。
PixVerse API 文件地圖：真正的文件在哪裡
搜尋 PixVerse API 文件會出現四個第一方頁面，以及一堆經銷商。其中重要的四個：
| 頁面 | URL | 涵蓋內容 |
|---|---|---|
| 平台文件 | docs.platform.pixverse.ai | 快速入門、完整 API 參考、點數價格、錯誤參考、常見問題 |
| 開發者控制台 | platform.pixverse.ai | 建立 API 金鑰、購買點數套裝、查詢用量 |
| 消費者應用程式 | app.pixverse.ai | 網頁應用程式。其方案、免費點數、浮水印規則不適用於 API |
| 官方 MCP 伺服器 | github.com/PixVerseAI/PixVerse-MCP | 官方封裝元件，讓 AI 助手可直接呼叫 PixVerse |
最讓人困惑的是 app 與 platform 的區別。app 銷售月費方案（從 10 美元起），並提供不定量的每日免費點數。platform 則在另一個獨立的帳本上銷售 API 點數與會員資格。付費的 app 訂閱不會給 API 方任何權益，反之亦然。
一個真正有用的細節藏在平台文件裡：一個名為 PixVerse-api-llm.txt 的純文字彙整頁面，將整個 API 參考打包成一份文件。將其貼入你的程式碼助手，它就能根據當前規格撰寫 PixVerse 呼叫，而不會依賴訓練資料中的過時資訊。
文件描述的服務背後有「超過 1 億名創作者與企業，遍及 175 個國家」。規模是真實的。隨之而來的版本更迭，正是本文設有「矛盾之處」章節的原因。
目前使用 PixVerse AI API 的兩種方式
直接整合 PixVerse 自家平台的方式，將在下一節詳細說明。最快接觸模型的方法是透過主機：Atlas Cloud 在其 400 多個模型中提供 PixVerse V6 與 C1，按秒計費（美元），無需點數套裝，也沒有浮水印。PixVerse 系列頁面列出所有九個託管端點，從文字轉影片、參考轉影片到延伸。兩種進入方式：先在 Playground 測試，然後從程式碼呼叫同一個端點。自然的起點是 V6 文字轉影片 Playground。
方法 1：在 Playground 測試 PixVerse V6 API
在寫程式碼之前，先花十分鐘在這裡。Playground 與你的程式碼將呼叫的端點完全相同，並附有價格報價。
- 登入並開啟 Playground。 提示詞欄位是唯一必填項目。
- 設定長度、品質與畫面比例。 預設為 5 秒、720p、16:9。
- 檢查音訊開關。 音訊預設為開啟，會提高每秒費率。
- 查看「執行」按鈕。 它會顯示當前設定下的確切費用。根據預設值，這是 0.30 美元，所以 10 美元大約可以執行 33 次。
- 執行、檢視、下載。 反覆調整提示詞，直到輸出滿意為止，然後將該精確設定移入程式碼。
方法 2：從程式碼呼叫 PixVerse V6 API
在 Atlas Cloud 上，PixVerse V6 開發者工作流程只有兩個 HTTP 請求。
步驟 1：取得 API 金鑰。 在 Atlas Cloud 控制台建立金鑰，並將其儲存為環境變數，切勿寫在用戶端程式碼中。
圖片：Atlas Cloud 控制台 API 金鑰頁面截圖，顯示建立金鑰按鈕以及一個剛產生的金鑰及其複製控制項。
步驟 2：查閱 API 文件。 端點、參數與驗證資訊都在 API 文件中。
步驟 3：發送你的第一個請求。 提交工作：
plaintext1curl -X POST https://api.atlascloud.ai/api/v1/model/generateVideo \ 2 -H "Content-Type: application/json" \ 3 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \ 4 -d '{ 5 "model": "pixverse/v6/text-to-video", 6 "prompt": "A slow dolly shot through a rain-wet night market, neon signs reflecting in puddles, steam rising from food stalls", 7 "duration": 5, 8 "quality": "720p", 9 "aspect_ratio": "16:9", 10 "sound": true 11 }'
回應會回傳一個預測 ID。輪詢該 ID 直到狀態變為 completed：
plaintext1curl https://api.atlascloud.ai/api/v1/model/prediction/<prediction_id> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
完成後的回應會帶有託管的影片 URL。持續的好處是請求格式：Atlas Cloud 對所有模型使用同一套 API，因此一個金鑰、一個驗證標頭、一個提交與輪詢迴圈，就能涵蓋 PixVerse 以及你未來加入的任何模型。切換模型只需要改變 model 字串，其他都不變。
深入 PixVerse 官方 AI API 文件：實際呼叫流程
如果你選擇直接整合 PixVerse 自家平台，API 概述定義了三個階段的流程，基礎網域為 app-api.pixverse.ai：
| 階段 | 端點 | 說明 |
|---|---|---|
| 上傳（僅限圖片轉影片） | POST /openapi/v2/image/upload | 多部分表單。PNG、WebP 或 JPEG，小於 20MB。回傳 img_id 整數 |
| 生成 | POST /openapi/v2/video/text/generate | JSON 主體。回傳 video_id |
| 輪詢 | GET /openapi/v2/video/result/{video_id} | 狀態 1 表示完成，回應中帶有下載 URL |
每次呼叫都需要兩個標頭進行驗證。API-KEY 存放來自平台控制台的金鑰。Ai-trace-id 必須是每個請求獨一無二的 UUID；文件警告，重複使用同一個 UUID 會阻止新生成任務啟動。
目前的文字轉影片參考標示五個必填欄位：prompt（最多 5,000 個字元）、model、duration、quality 與 aspect_ratio。model 列舉值接受八個：v3.5 到 v5.6，加上 v6 與 c1。duration 限制依生成模型而定：v5 以前為 5 或 8 秒，v5.5 與 v5.6 可選 10 秒，v6 與 c1 則可選 1 到 15 秒。音訊透過 generate_audio_switch 選擇加入，預設為 false。這個預設值對預算很重要：上述 Atlas Cloud Playground 預設音訊為開啟，因此兩個途徑對看似相同的片段會報出不同的價格。
圖片轉影片則需要先進行上傳步驟。無法直接傳遞公開圖片 URL；你必須上傳檔案，取得回傳的 img_id，然後在生成主體中引用它。
兩個實務操作重點，均來自錯誤參考：同時進行的生成任務數量受會員等級限制，卡住的任務約 10 分鐘後會自動釋放。此外，輪詢狀態值得明確處理：7 表示提示詞觸發內容審查，8 表示伺服器端錯誤，值得重試。
PixVerse API 文件中的矛盾之處
PixVerse API 文件混合了最新的端點參考與未完全更新的舊教學頁面。讀錯頁面會浪費大量除錯時間。以下是我們直接驗證的衝突：
| 主題 | 較舊的文件頁面說 | 目前的參考文件說 |
|---|---|---|
| negative_prompt | 在 API 概述的範例請求主體中出現 | 生成端點上沒有這個欄位 |
| water_mark | "water_mark": false 出現在相同範例中 | 目前參數列表中沒有這個欄位 |
| 片段長度 | MCP README 硬編碼為 "5s 或 8s" | v6 與 c1 可選 1 到 15 秒 |
| 圖片上傳限制 | 疑難排解頁面：4000×4000 像素 | 上傳參考：10,000 像素 |
| 提示詞長度 | 教學指南：保持提示詞在 25 到 200 個單詞 | 硬性上限 5,000 個字元，無單詞數建議 |
兩條規則涵蓋上述五個情況。當頁面不一致時，請相信端點參考文件而非教學頁面；參考文件承載當前規格，教學頁面則承載歷史。當限制不一致時，請按照較嚴格的限制撰寫程式碼，例如上傳時使用 4000 像素。
版本列舉值也值得特別提醒。舊的模型名稱仍然有效：v3.5、v4 與 v4.5 仍是有效值，因此 2025 年時代的整合不會中斷。只是會多花錢。在 720p、5 秒、無音訊的設定下，官方計費對 V4 收取 60 點，但對 V6 只收 45 點。如果你接手了一個使用舊模型字串的程式碼庫，升級它只需一行更改，就能降低成本並改善輸出。只有 V2 世代已完全從第一方存取中移除。
PixVerse API 價格：平台用點數，Atlas Cloud 用美元
PixVerse 官方平台以點數計費，其價格頁面將模型表格標示為「按秒計算」。點數套裝從 10 美元買 1,000 點到 5,000 美元買 500,000 點，月費會員則從 100 美元的 Essential 方案（15,000 點）到 6,000 美元的 Business 等級。目前模型每秒消耗的點數：
| 品質 | V6（無音訊 / 有音訊） | C1（無音訊 / 有音訊） |
|---|---|---|
| 360p | 5 / 7 點 | 6 / 8 點 |
| 540p | 7 / 9 點 | 8 / 10 點 |
| 720p | 9 / 12 點 | 10 / 13 點 |
| 1080p | 18 / 23 點 | 19 / 24 點 |
Atlas Cloud 對同樣兩個模型以美元按秒計費，無需先購買套裝或會員。2026 年 7 月 23 日在線模型頁面驗證，為牌價且無折扣：
| 品質 | V6（無音訊 / 有音訊） | C1（無音訊 / 有音訊） |
|---|---|---|
| 360p | $0.025 / $0.035 | $0.030 / $0.040 |
| 540p | $0.035 / $0.045 | $0.040 / $0.050 |
| 720p | $0.045 / $0.060 | $0.050 / $0.065 |
| 1080p | $0.090 / $0.115 | $0.095 / $0.120 |
一個片段就能讓比較具體化。一個 5 秒 720p 的 V6 片段含音訊，需要 60 點：以 10 美元套裝計算約為 0.60 美元，若以 Essential 會員費率（每月 100 美元，獲得 15,000 點）則約為 0.40 美元。在 Atlas Cloud 上按秒計費，同樣的片段是 0.30 美元。C1 模型每秒價格稍高，透過 C1 Playground 執行相同片段需要 0.325 美元，這換來了其電影級調校。
對於已經在 PixVerse 平台內的團隊，尤其在高用量 Scale 等級時，點數仍然合理。對其他人來說，按秒計費的美元價格更容易預測：每次渲染的價格等於長度乘以費率，在花費前就能看到。
PixVerse AI 開發者公司
API 是對其背後公司的賭注。在開始建置之前，了解 PixVerse AI 的開發者公司是值得的。PixVerse 由 AISphere（愛世科技）打造，2023 年 4 月在北京成立，現總部設於新加坡，約有 150 名員工。創辦人兼執行長王長虎曾在 2017 至 2021 年領導字節跳動的 AI Lab 視覺工作，這使得 PixVerse 成為其前僱主所打造的 Seedance 的直接競爭對手。共同創辦人謝杰登來自 Lighthouse Capital。
對於一家獨立的影片模型工作室來說，其募資狀況異常強勁。2026 年 7 月 13 日，該公司完成了 C 輪延伸募資，使該輪總額達到 4.39 億美元，估值超過 20 億美元，阿里巴巴加入，根據 TechCrunch 的報導。對開發者而言，這意味著資金充足：你本季整合的 API 不太可能明年就消失。
資金充裕的實驗室另一面是出貨速度。僅 2026 年的發佈時程：
三個月內推出三個模型，這解釋了本文不斷提及的文件滯後問題。請據此建置：鎖定你的模型字串，在升級前閱讀版本說明，然後重新檢查端點參考文件，不要假設上一季的參數仍然存在。
常見問題
官方 PixVerse API 文件在哪裡？
位於 docs.platform.pixverse.ai，開發者控制台在 platform.pixverse.ai。任何在 app.pixverse.ai 上的內容都是消費者產品，而第三方「PixVerse API 文件」頁面通常描述的是 v4 時代的參數。文件中也包含一份彙整的 LLM 就緒文字頁面，可餵給程式碼助手。
如何取得 PixVerse API 金鑰？
在平台控制台 platform.pixverse.ai 註冊，建立金鑰，然後在每次請求中透過 API-KEY 標頭以及獨一無二的 UUID（Ai-trace-id）傳遞。金鑰與平台點數綁定，點數需與任何消費者應用程式訂閱分開購買。在 Atlas Cloud 上，等效的是透過控制台金鑰，以標準的 Bearer Token 形式傳遞。
PixVerse API 有免費層級嗎？
平台價格文件僅列出付費點數套裝與會員資格。PixVerse 廣告中的不定量每日免費點數屬於消費者應用程式，不會流入 API 帳本。最便宜的付費入門點是官方平台的 10 美元點數套裝，或 Atlas Cloud 上從每秒 0.025 美元起的按秒計費生成。
PixVerse API 可以執行哪些模型？
目前的生成端點接受八個模型值：v3.5、v4、v4.5、v5、v5.5、v5.6、v6 與 c1。V6 與 C1 是當前世代，支援 1 至 15 秒片段與可選的原生音訊。較舊的名稱仍然有效，但在相同設定下會比 V6 花費更多點數。V2 世代已不再提供第一方存取。
PixVerse AI API 每支影片的費用是多少？
官方平台：一個 5 秒 720p 的 V6 片段含音訊，需要 60 點，以 10 美元套裝計算約為 0.60 美元。Atlas Cloud：相同片段按秒計費為 0.30 美元，每秒價格範圍從 0.025 美元到 0.115 美元，視解析度與音訊而定。C1 稍高，該片段為 0.325 美元。價格於 2026 年 7 月 23 日驗證。
結論
PixVerse API 的狀況比其文件要好。服務本身快速、資金充足且現代化：八個模型值、最長 15 秒的片段、同一趟完成音訊，以及任何初級開發者都能在一個下午串接好的非同步流程。只是文件未能跟上發佈時程，因此端點參考文件與教學指南描述的是不同的產品。
運作方法很簡單。相信端點參考文件，當頁面不一致時按照較嚴格的限制撰寫程式碼，並鎖定你的模型字串。然後選擇你的計費方式：如果你的團隊已經在官方平台，就使用點數；如果你希望每次渲染的價格在送出前就能看到，則使用每秒 0.025 美元起的按秒計費。Playground 中預設 0.30 美元的片段是一個便宜的起點，讓你知道自己屬於哪一邊。
