接口请求域名： hunyuan.intl.tencentcloudapi.com 。
输入模型后，可根据语义或图片进行模型纹理重绘。
默认接口请求频率限制：20次/秒。
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：SubmitHunyuanTo3DTextureEditJob。 |
| Version | 是 | String | 公共参数，本接口取值：2023-09-01。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| File3D | 是 | InputFile3D | 需进行纹理编辑的3D文件URL，可支持FBX,OBJ,GLB格式。 |
| Image | 否 | ImageInfo | 3D模型纹理编辑参考图 Base64 数据和参考图图 Url。 - Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 - 图片限制：单边分辨率小于4096且大于128，转成 Base64 字符串后小于 10MB，格式支持 jpg、jpeg、png。 |
| Prompt | 否 | String | 纹理编辑的描述，中文正向提示词。 最多支持1024个 utf-8 字符。 image和 prompt必填其一，且prompt和image不能同时存在。 示例值：一只小猫 |
| EnablePBR | 否 | Boolean | 是否开启PBR纹理参数，仅支持Prompt输入时开启。 示例值：ture |
| 参数名称 | 类型 | 描述 |
|---|---|---|
| JobId | String | 任务id（有效期24小时）。 |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
POST / HTTP/1.1
Host: hunyuan.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitHunyuanTo3DTextureEditJob
<公共请求参数>
{
"File3D": {
"Type": "FBX",
"Url": "https://vcg-test-1258344699.cos.ap-guangzhou.myqcloud.com/test/3d/test.fbx"
}
}
{
"Response": {
"JobId": "1384898587778465792",
"RequestId": "5265eb4a-0f4f-4cb1-9b3d-d9f1fb9347d2"
}
}
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
该接口暂无业务逻辑相关的错误码，其他错误码详见 公共错误码。
文档反馈