Rodin Generation
最后更新于
这有帮助吗?
最后更新于
这有帮助吗?
使用此API向我们的服务器提交异步任务。你将从API中获得一个任务UUID,该UUID可用于和。
Base Cost: `Sketch`
和`Regular`
每次生成消耗 0.5 Credit。
Addons:
HighPack
: 每次生成额外消耗 1 Credit。
images
file/Binary
用于图像生成,最多上传5张图片。由于form-data请求将保留图像的顺序,因此将会使用上传列表的第一张图片来生成材质贴图。 对于Image-to-3D模式,图片是必须的。可上传一张或多张图片。(最多上传5张图片。) 对于Text-to-3D模式,则不需要上传图片。
prompt
string
用于指导模型生成的文本提示。 对于Image-to-3D生成模式是可选的。(如果没有提供,将使用基于提供的图像的人工智能生成的提示。) 对Text-to-3D模式是必须的。
condition_mode
string
该参数仅用于多图像生成。
这是一个可选的参数,用于选择多图生成时的生成方式。可能的值为fuse
或concat
。默认值为concat
。
对于fuse
模式,需要上传一张或多张图片。可以融合多张图片的物体特征生成一个模型。
对于concat
模式,需要上传同一物体的多张多视角图片,并生成该模型。(无须在意上传图片的顺序。)
seed
number
可选的。网格生成中用于随机化的种子值,范围从0到65535(包括两者)。如果不提供,种子将随机生成。
geometry_file_format
string
可选的。模型文件的格式。可能的值为glb
,usdz
,fbx
,obj
,stl
。默认值为glb
。
material
string
可选的。材质类型。可能的值为PBR
和shade
。默认值为PBR
。
对于Rodin Sketch,该值仅为PBR
时生效。
quality
string
可选的。生成质量。可能的值为high(50k面)
, medium(18k面)
, low(8k面)
, 和extra-low(4k面)
。默认值为medium
。
对于Rodin Sketch,该值仅为medium
时生效。
use_hyper
boolean
可选的。默认值为false
在生成具有更精细结构的对象时,将use_hyper
设置为true
,则3D模型的质量会更好。
对于Rodin Sketch,该值仅为false
时生效。
tier
string
可选的。生成层级。
对于Rodin Sketch,该值应该设置为Sketch
。
对于Rodin Regular,该值应该设置为Regular
。
TAPose
bool
可选的。控制生成类人模型时,生成结果展现为T/A Pose。
当该值为true
时,生成的模型将为Tpose或者Apose。
bbox_condition
Array of Integer
可选的。该参数是一个控制生成模型最大生成边界的control net. 通常来说,这个数组包含三个元素,分别是宽度(y轴),高度(z轴)和长度(x轴)。
mesh_mode
string
可选的,可选的值有Raw
和Quad
. 默认值为Quad
.
Raw
模式会生成三角面模型。
Quad
模式生成四边面模型。
mesh_simplify
bool
可选的。当值为true
时,将会生成简化模型。
该参数仅当mesh_mode的值为Raw
时生效。并且当该参数的值为true
时,其他所有可选参数均设置为默认值。
addons
array of strings
可选的。生成附加功能。默认为[]
。可能的值为HighPack
.
HighPack
选项会提供4K分辨率的纹理贴图而不是基础的2K分辨率,同时还会提供更高面数的模型文件。
error
string
错误信息(如有)
message
string
成功信息或详细的错误信息。
uuid
string
生成任务的唯一标识符。
jobs
object
一个作业对象,包含作为生成过程一部分执行的各个作业的详细信息。
jobs.uuids
array of strings
子任务的UUIDs。
jobs.subscription_key
string
任务密钥
此API使用密钥进行身份验证。您需要在所有请求的Authorization
头中包含一个有效的密钥. 参阅获取您的账户的API生成密钥。
对于的task_uuid
,使用uuid
字段替代jobs_uuid
。
This API will generate a mesh and textures for the given images and prompt. This API provide two tiers of generation, Sketch and Regular. Sketch is optimized for generation speed, and is recommended for fast prototyping. Regular is optimized for quality, and is recommended for production.
concat
Available options: glb
Available options: PBR
Available options: medium
Available options: false
false
[]
Quad
Available options: true
true
[]