开始使用
核心概念
Rodin 的异步请求生命周期与各生成系列。
请求流程
Rodin 采用异步生成流程：
- 向 Rodin Gen-2.5、Rodin Gen-2或 Rodin Gen-1/1.5提交任务。
- 使用
jobs.subscription_key调用查询状态，直到所有 job 完成。 - 使用生成响应顶层的
uuid调用下载结果。
快速开始提供了包含退避、失败处理和总期限的完整实现。
生成模型系列
Rodin Gen-2.5
支持 Image-to-3D、Text-to-3D、多种 tier、网格参数、纹理参数和 Add-ons。准确的 enum 值与默认值以页面中的 OpenAPI 展示为准。
Rodin Gen-2
支持 Image-to-3D 和 Text-to-3D，以及 Gen-2 对应的网格、材质、纹理和 Add-on 参数。
Rodin Gen-1/1.5
支持 Sketch、Regular、Detail 和 Smooth tier，以及多图 concat 与 fuse 行为。
Credits 与计费
每次成功受理的提交都会通过 consumed 返回本次消耗的 credits，查询余额则返回账户剩余的 credits。由于并发任务会消耗同一份余额，返回的余额应视为某一时刻的读数，而不是预留额度。
各 tier 的价格与 credit 单价以官方定价页为准，可能独立于本文档变化。提交付费任务前请先在该页面确认当前价格。
账户同时还有并发任务数量上限。超出该上限时提交会被拒绝并返回 API_PARALLELISM_LIMIT_REACHED，可在已有任务完成后重试。完整错误码列表和限流行为参见错误码。