进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读

第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 ' \ --header 'content-type: application/json' \ --data ' { "model": "rodin-v2", "public": false, "parameters": { "quantity": 1, "output_format": "glb", "mesh_mode": "Quad", "quality": "high", "material": "PBR", "seed": 12345, "ta_pose": true, "bounding_box": [100, 200, 100], "use_original_alpha": true, "guidances": { "image_reference": [ { "image": { "id": "00000000-0000-0000-0000-000000000001", "type": "GENERATED" }, "strength": "HIGH" }, { "image": { "id": "00000000-0000-0000-0000-000000000002", "type": "UPLOADED" }, "strength": "MID" } ] } } } '

用法说明

API 请求端点、请求头与参数

端点

https://cloud.leonardo.ai/api/rest/v2/generations

请求头

--header "accept: application/json" \ --header "authorization: Bearer " \ --header "content-type: application/json"

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。

译文

评论 (0)