Graydient AI 渲染 API
如果你在建置應用程式、內部工具或渲染管線，Graydient 提供專用 GPU 上的開放影像、影片與 LLM 模型，統一 API，固定月費。
包含此功能的方案
個人 API 僅隨 Video Max 提供：年繳為每月 $84（年繳共 $999），月繳為 $99.99。Images 與 Video Plus 不含 API 存取。你可隨時在 帳單入口 升降級或取消，費用按比例計算。
個人 API 是一個使用者專用金鑰，不得轉售。有限速：約每 10 秒呼叫一次，避免批次呼叫。若請求過多，金鑰可能自動失效。
建置多用戶或白標產品
虛擬用戶與白標登入是商業級功能，適用於多用戶產品。它們可在個人 API 上運作，讓你在開發階段於 Video Max 測試多用戶與白標流程。
正式推出多用戶產品或轉售存取權需商業級方案：專用 GPU 伺服器或商業協議。洽談商業部署請寫信至 info@graydient.ai。
| 個人 API（Video Max） | 商業部署 | |
|---|---|---|
| 用戶 | 一位用戶（你） | 你的產品用戶 |
| 轉售 | 不允許 | 允許 |
| 虛擬用戶與白標登入 | 建置與測試 | 正式上線 |
| 取得方式 | 訂閱 Video Max | 專用 GPU 伺服器或商業協議 |
API 運作方式
目前版本為 V3，位於 https://cloud.graydient.ai/api/v3/。遵循 JSON:API 規範：傳送與接收 application/vnd.api+json，使用 API 代幣頁面的標準 HTTP Bearer 令牌進行驗證，並從帶有 attributes 成員的 data 物件讀取結果。
渲染為非同步。你將帶有提示詞和必填 callback_url 的請求 POST 到 POST /api/v3/render/。Graydient 會立即回覆 render_hash 以及預估等待與渲染時間。工作完成後，會將結果 POST 到你的 webhook。可選欄位包括：
- error_url：失敗時的 webhook
- init_image 和 mask_image：用於圖像到圖像及修補
- placeholders：ControlNet 模式或 IP 適配器的命名圖片 URL
- progressive_return：每張圖片回調一次
- session_id：將渲染與你自己的用戶關聯
工作流程透過同一端點執行，提示詞中帶有 workflow 指令。
無需輪詢的狀態查詢：GET GET /api/v3/render/{render_hash} 回傳渲染狀態，但文件建議不要輪詢。請使用 webhook，或 wss://cloud.graydient.ai/render-events/{render_hash} 的 WebSocket 串流，會傳送 started、image_done、done 和 error 事件。
其他端點系列
- 聊天：帶有角色的 LLM 聊天。回覆會送到回調或同步帶 sync: true 時內嵌回傳，視覺模型接受 image_url。
- 概念：列出可用模型與 LoRA。
- 工作流程：列出工作流程及其支援的功能，如 txt2img、img2img、txt2vid 和 img2vid。
- 知識庫：建立領域、加入事實、爬取 URL，然後搜尋或聊天。
- 技能：將自然語言請求轉成工作流程指令。
- 虛擬用戶：將你的終端用戶映射到你的帳戶記錄。個人 API 上建置與測試，商業部署時正式上線。
完整參考：API 文件。文件說明仍在開發中。
典型使用案例
- 驅動你自己的應用程式：使用 Graydient 作為圖像、影片或聊天功能的渲染後端。在個人 API 上開發，真實用戶到來時轉移到商業部署。
- 使用你託管的模型：使用你安裝的 LoRA 和檢查點渲染。詳見 自行架設 AI 模型。
- 遠端運行 ComfyAPI 風格工作流程：從你自己的程式碼呼叫映射的工作流程。
- 產品與目錄影像：在個人 API 的速率限制內，升級、編輯或重新風格化管線中的圖片。
- 批次渲染：持續大量批次時，使用專用 GPU 伺服器取代個人 API。
- 知識庫聊天：在知識庫與聊天端點上建立支援或文件助理。
專用 GPU 伺服器
若你計畫運行多用戶產品、轉售 API 存取或全天批次渲染，Graydient 提供每月 $499.99 的專用 Video Max GPU 伺服器。你將擁有自己的機器，無需排隊，可執行較長工作並設定客戶可用功能與排隊時長限制。可隨成長堆疊多台伺服器，合約需提前 30 天通知，無長期綁約。
專用伺服器渲染價格：專用伺服器上的渲染每次 $0.02，包含影片。此單次渲染價格僅適用於專用伺服器。Images、Video Plus 和 Video Max 計畫維持固定費率，無單次渲染費用。
租用請寫信至 info@graydient.ai。
開始使用
- 訂閱 Video Max。你可隨時在 帳單入口 變更或取消方案。
- 在你的 API 代幣頁面建立一個代幣。
- 閱讀 API 文件 並在 GitHub 查看 Graydient API 的範例用法。
- 設定 webhook 端點，然後送出第一個渲染請求。
- 依文件建議，在提供給用戶前先鏡像與縮圖結果圖片。
API 支援可透過電子郵件 info@graydient.ai 聯絡。所有使用須遵守 可接受使用政策 與 使用條款。