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 成员的数据对象中读取结果。
渲染是异步的。你向 POST /api/v3/render/ POST 提示和必需的 callback_url。Graydient 会立即回复 render_hash 以及预计等待和渲染时间。作业完成后，它会将结果 POST 到你的 webhook。可选字段包括：
- error_url：失败时的 webhook
- init_image 和 mask_image：用于图像到图像和修补
- placeholders：ControlNet 模式或 IP 适配器的命名图像 URL
- progressive_return：每张图像一次回调
- session_id：将渲染与您自己的用户关联
工作流通过同一端点运行，提示中带有工作流命令。
无轮询状态：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 提供。所有使用均受 可接受使用政策 和 使用条款 约束。