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 成员的数据对象中读取结果。
渲染是异步的。你向 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 访问或全天批量渲染，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 提供。所有使用均受 可接受使用政策 和 使用条款 约束。