Roblox 3D 物品
已上线描述它或上传图片，得到可导入 Roblox Studio 的 Roblox 尺寸 3D 物品（FBX + GLB）。按模型从余额扣费。
$0.99 起提示词或图片 · 在配饰面数上限内 · Studio 用 FBX
3D 流水线如何运作
和我们为自家游戏制作角色时用的步骤完全一样。
- 01T 姿势检查快速查看你的图片。如果不是纯色背景下闭嘴、表情自然的标准正面 T 姿势，就保持同一角色重新画成这样。张开的手臂能让手部干净。
- 023D 模型用 T 姿势图片生成带贴图、可直接用于游戏的网格，使用 PBR 材质并去除烘焙光照。角色和道具各有自己的三角面预算。
- 03绑定骨骼为角色匹配骨骼让它能动，需要时附带走路和跑步动画。你会得到用于游戏引擎的 FBX 和用于网页的 GLB。
一次调用完成全部三步：3D 角色
从代码调用 Roblox 3D 物品
每个 3D 工具都是独立的端点。每次调用都返回一个任务：轮询直到完成。失败的运行不收费。
POST
https:/- GET
/进度和输出文件。v1/ tasks/ {id} - GET
/3D 引擎和质量档位，附价格v1/ models? category= 3d
获取 API 密钥
在控制台创建密钥。它与试用区使用同一余额。
创建密钥发送第一个请求
与试用区发送的请求相同。把 OPENNAN_KEY 设为你的密钥。
curl https://api.opennan.com/v1/roblox/models \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"kind":"item","prompt":"a wooden treasure chest with gold trim"}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"查询任务
调用会立即返回任务 ID。查询任务直到完成：
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- 等待处理
- running
- 生成中
- succeeded
- 完成：outputs[].url 中是文件
- failed
- 失败：不收费
错误及解决方法
401缺少密钥或密钥错误
用 Authorization: Bearer 请求头发送控制台中的密钥。
402余额不足
在账单页面充值，然后重新发送同一请求。
400有值不被接受
查看 error.message，它会指出字段。请使用参数表中的值。
429请求过多
等几秒再试，每次遇到 429 都等得更久一些。
Roblox 3D 物品：常见问题
Roblox 3D 物品 多少钱？
按次付费，价格在开始前显示。
如何从代码调用？
带上 API 密钥发送 POST https://api.opennan.com/v1/roblox/models。返回任务 ID：查询 https://api.opennan.com/v1/tasks/{id}，直到任务成功或失败。
我的 AI 智能体能用吗？
能。让智能体阅读 https://api.opennan.com/llms.txt，里面说明了这个接口和其他所有接口。
运行失败会怎样？
失败的运行不收费。只为结果付费。
我会得到哪些文件?
用于网页、游戏引擎和 3D 应用的 GLB，用于 Roblox Studio、Unity、Unreal 和 Blender 的 FBX，以及一张缩略图。绑定骨骼的运行还会附带走路和跑步动画。