第59章 Leonardo.AI API 教程:使用 Rodin V2 生成 3D 资产
Rodin V2本指南介绍如何通过 Leonardo.AI REST API 使用 Rodin V2 模型生成 3D 资产。
请求示例
curl --request POST \
--url https://cloud.leonardo.ai/api/rest/v2/generations \
--header 'accept: application/json' \
--header 'authorization: Bearer
用法说明
API 请求端点、请求头与参数
端点
https://cloud.leonardo.ai/api/rest/v2/generations
请求头
--header "accept: application/json" \
--header "authorization: Bearer
Body 参数
参数类型说明bounding_boxarray包围盒尺寸,格式为 [宽度, 高度, 长度],必须包含恰好 3 个整数,用于限制生成模型的大小。guidances.image_referencearray角色或物体的多角度参考图,最少 1 张、最多 5 张。每项包含 image.id、image.type(GENERATED 或 UPLOADED)和 strength(LOW、MID 或 HIGH)。materialstring生成网格的材质模式。可选值:PBR(基于物理的材质)、Shaded(烘焙着色)、All(两者都包含)。默认为 All。mesh_modestring生成网格的面片类型。可选值:Quad(四边形面,表面更平滑)和 Triangle(三角形面,几何细节更丰富)。默认为 Triangle。modelstring指定用于生成的模型,设为 rodin-v2。output_formatstring生成的 3D 资产网格文件格式,设为 glb。publicboolean控制生成的资产是公开(true)还是私有(false)。qualitystring生成质量等级。可选值:extra_low、low、medium、high,默认为 high。多边形数量取决于 mesh_mode(参见“约束条件”)。quantityinteger每次请求生成的资产数量,设为 1。seedinteger用于可复现生成的种子值,范围:0–65535。ta_poseboolean对人物角色网格施加 T/A-pose 约束,使结果更易于绑定骨骼和制作动画。默认为 false。use_original_alphaboolean保留输入图像的原始 alpha 通道。默认为 false。
约束条件
guidances.image_reference 每次请求可接受 1 到 5 张参考图。
quantity 固定为 1,每次请求只生成单个资产。
output_format 固定为 glb。