任务：图片转3D模型

简洁描述：使用图片转3D模型接口，将2D图像快速转换为3D模型文件。

---

概览

• 请求方法：POST
• 路径：/task/gi/image-to-3d
• 内容类型：multipart/form-data

认证方式

• Header：Authorization: Bearer <token>

---

请求示例

表单参数

参数	类型	必填	说明
model	string	是	选择模型，支持 Hunyuan3D-2、Hi3DGen、Step1X-3D
image	file	是	PNG 背景透明图像文件，用于生成 3D 模型
texture	boolean	否	是否生成纹理，默认 false
num_inference_steps	number	否	迭代次数，越大生成质量越高，范围 2-50，默认 5
octree_resolution	number	否	3D 渲染/体素精度，范围 16-400，默认 128
guidance_scale	number	否	模型对提示词遵从程度，范围 1-20，默认 5
file_format	string	否	输出格式，glb 或 stl；Hunyuan3D-2 不支持该参数，默认 glb
type	string	否	输出格式，仅 Hunyuan3D-2 支持该参数，示例 glb
seed	number	否	随机种子，范围 0-10000000，默认 1234

---

curl 示例

curl -X POST "https://api.gpt.ge/task/gi/image-to-3d" \
  -H "Authorization: Bearer sk-xxxx" \
  -F "model=Hunyuan3D-2" \
  -F "image=@/path/to/image.png" \
  -F "texture=false" \
  -F "num_inference_steps=5" \
  -F "octree_resolution=128" \
  -F "guidance_scale=5" \
  -F "file_format=glb" \
  -F "seed=1234"

JavaScript (fetch) 示例

const formData = new FormData();
formData.append('model', 'Hunyuan3D-2');
formData.append('image', fileInput.files[0]);
formData.append('texture', 'false');
formData.append('num_inference_steps', '5');
formData.append('octree_resolution', '128');
formData.append('guidance_scale', '5');
formData.append('file_format', 'glb');
formData.append('seed', '1234');

fetch('https://api.gpt.ge/task/gi/image-to-3d', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk-xxxx'
  },
  body: formData
}).then(r => r.json()).then(console.log);

Python（requests）示例

import requests

url = 'https://api.gpt.ge/task/gi/image-to-3d'
headers = {
    'Authorization': 'Bearer sk-xxxx'
}

files = {
    'image': open('image.png', 'rb')
}
data = {
    'model': 'Hunyuan3D-2',
    'texture': 'false',
    'num_inference_steps': 5,
    'octree_resolution': 128,
    'guidance_scale': 5,
    'file_format': 'glb',
    'seed': 1234
}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

---

返回示例（200）

{
  "task_id": "SPC6X7SLGD0HCJMWFQ3RTLRUNZZV4I1M",
  "status": "waiting",
  "created_at": 1744534393609,
  "urls": {}
}

注意：Hunyuan3D-2 不支持 file_format 参数；当需要生成纹理时，将 texture 设置为 true。此接口推荐上传 PNG 背景透明图像以获得更好效果。