Generate Texture
贴图生成
授权
请求体
imagestring · binary必填
promptstring可选
modelbinary必填
seednumber可选
geometry_file_formatstring · enum可选Default:
glb
可能的值: materialstring · enum可选Default:
PBR
可能的值: escorenumber可选Default:
3.5
reference_scalenumber可选Default:
1
resolutionstring · enum可选Default:
Basic
可能的值: 响应
201成功
application/json
post
POST /api/v2/rodin_texture_only HTTP/1.1
Host:
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 156
{
"image": "binary",
"prompt": "text",
"model": null,
"seed": 1,
"geometry_file_format": "glb",
"material": "PBR",
"escore": 3.5,
"reference_scale": 1,
"resolution": "Basic"
}
201成功
{
"error": "text",
"message": "text",
"uuid": "text",
"submit_time": null,
"jobs": {
"uuids": [
"text"
],
"subscription_key": "text"
}
}
贴图生成
使用此API向我们的服务器提交异步任务。你将从API中获得一个任务UUID,该UUID可用于检查进度和下载结果。
价格
每次调用该API生成需要消耗 0.5 credits。
Request
Authentication
此API使用密钥进行身份验证。您需要在所有请求的Authorization
头中包含一个有效的密钥. 参阅快速开始获取您的账户的API生成密钥。
Authorization: Bearer RODIN_API_KEY
Body
参数
类型
描述
image
file/Binary
必须. 上传一张图片文件作为生成贴图的图片参考。
prompt
string
可选的。一段描述贴图的文字,指导贴图生成。
model
file/Binary
必须. 上传一个二进制的三维模型文件进行处理。
seed
number
可选的。网格生成中用于随机化的种子值,范围从0到65535(包括两者)。如果不提供,种子将随机生成。
reference_scale
number
可选的。表示纹理生成过程中的参考尺寸。
geometry_file_format
string
可选的。模型文件的格式。可能的值为glb
,usdz
,fbx
,obj
,stl
。默认值为glb
。
material
string
可选的。材质类型。可能的值为PBR
和Shaded
。默认值为PBR
。
resolution
string
可选的。 输出贴图的分辨率。可能的值为Basic
和 High
. 默认是Basic
.
样例
export RODIN_API_KEY="your api key"
curl https://api.hyper3d.com/api/v2/rodin_texture_only \
-H "Authorization: Bearer ${RODIN_API_KEY}" \
-F "image=@/path/to/your/image.jpg" \
-F "model=@path/to/your/model.obj" \
-F "reference_scale=1.0" \
-F "geometry_file_format=glb" \
-F "material=PBR" \
-F "resolution=High"
unset RODIN_API_KEY
最后更新于
这有帮助吗?