Graydient AI 渲染 API
如果你在建置應用程式、內部工具或渲染管線，Graydient 提供專用 GPU 上的開放影像、影片與 LLM 模型，統一 API，固定月費。
包含此功能的方案
個人 API 僅包含 Video Max。Images 和 Video Plus 不含 API 存取。你可隨時在 帳單入口 升級、降級或取消，費用按比例計算。商業方案與 API 價格請見 business.graydient.ai。
個人 API 僅供一位真人用戶，任何個人方案皆不允許自動化流量。禁止機器人、腳本、排程器、批次作業、爬蟲、多用戶應用或轉售存取。呼叫頻率限制約每 10 秒一次。發送自動化或過量流量的金鑰會被無預警撤銷。
建置多用戶或白標產品
虛擬用戶與白標登入是商業級功能，適用於多用戶產品。它們可在個人 API 上運作，讓你在開發階段於 Video Max 測試多用戶與白標流程。
若要正式上線多用戶產品、自動化流量或轉售存取，需商業方案：專用 GPU 伺服器。business.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 存取或批次渲染，需商業方案：專用 GPU 伺服器，擁有專屬機器且無共享佇列。價格、包含內容及訂購表單請見 business.graydient.ai。
專用伺服器的每次渲染計價（含影片）列於 business.graydient.ai。此每次渲染價格僅適用於商業方案。Images、Video Plus 和 Video Max 為固定費率方案，無每次渲染收費。
個人方案不允許自動化流量。Images、Video Plus 和 Video Max 是單一真人用戶的固定費率方案，發送自動化流量的金鑰會被撤銷。
開始使用
- 訂閱 Video Max。你可隨時在 帳單入口 變更或取消方案。
- 在你的 API 代幣頁面建立一個代幣。
- 閱讀 API 文件 並在 GitHub 查看 Graydient API 的範例用法。
- 設定 webhook 端點，然後送出第一個渲染請求。
- 依文件建議，在提供給用戶前先鏡像與縮圖結果圖片。
API 支援可透過電子郵件 info@graydient.ai 聯絡。所有使用須遵守 可接受使用政策 與 使用條款。