Hitem3D 2.0 API：价格、Playground 与文档

Q: Hitem3D 2.0 使用哪个端点？

Hitem3D 2.0 通过 api.empiriolabs.ai 上的 POST /v1/3d/generations 提供，使用标准的 Bearer 令牌认证。

关于 Hitem3D 2.0

以制作为中心的图像转3D，带有结构感知纹理，1536和1536 Pro的高精度层级，最多可进行200万个面部网格，以及五种导出格式。

image to 3dmulti viewhigh polytexture generation

Hitem3D 2.0 规格

模型 ID: hitem3d-2-0
开发方: Hitem3D
类别: 3D生成
发布日期: -
输入: 图像
输出: 3D
区域: Malaysia
端点: POST/v1/3d/generations
备用模型 ID: hitem3d-2.0hitem3d-2-0-251223

Hitem3D 2.0 API 价格

来自 EmpirioLabs 目录的实时按量计费价格。只为实际用量付费，没有月度最低消费。

类型

规格

价格

1536 纹理

按请求

$2.80

1536 Pro 纹理

按请求

$3.60

1536年白色型号

按请求

$1.60

1536 Pro 白色型号

按请求

$2.40

在完整价格页比较

如何调用 Hitem3D 2.0 API

Hitem3D 2.0 通过 POST /v1/3d/generations 运行。请求会立即返回 job_id；轮询 GET /v1/jobs/{job_id} 直到任务完成，再从结果中读取输出 URL。在EmpirioLabs 控制台获取 API 密钥。

cURL：提交任务

curl https://api.empiriolabs.ai/v1/3d/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hitem3d-2-0",
    "prompt": "Describe what you want Hitem3D 2.0 to generate."
  }'

cURL：轮询结果

curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Python

import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/3d/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "hitem3d-2-0",
        "prompt": "Describe what you want Hitem3D 2.0 to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)

Hitem3D 2.0 API 完整参考

Hitem3D 2.0 API 参数

EmpirioLabs 上 Hitem3D 2.0 API 支持的请求参数。省略字段时使用默认值。

参数	类型	默认值	范围 / 值	描述
image	image	-	-	一到四张输入图像。对于多个视图，使用multi_images_bit来声明视图顺序。
prompt	string	-	-	为该世代提供可选的指导文本。
resolution	enum	1536	1536, 1536pro	几何分辨率。1536pro是高精度级别，按代计费率更高。
texture	boolean	true	-	用几何体生成纹理。Off以较低的代价退回白人模型。
face_count	integer	-	100000 到 2000000	输出网格的目标多边形数。
file_format	enum	glb	glb, obj, stl, fbx, usdz	生成模型的3D文件格式。
multi_images_bit	string	-	-	四个0/1数字分别表示输入图像的视角顺序为：前、后、左、右。举例：前方加左侧1010。

须知

仅图像转三维：对象的一到四个视图（声明视图顺序，前、后、左、右顺序为multi_images_bit）。计费按所选分辨率和纹理设置的层级生成模型计费。

控制

1536标准或1536 Pro高精度几何形状。
纹理开在一遍内生成几何体和贴图;关闭时返回白色模型，速度较低。
目标人脸数量从100,000到2,000,000之间，以及glb、obj、stl、fbx或usdz的输出。

输入限制

图片：jpg、jpeg、png 或 webp，分辨率在 4096x4096 像素和 10 MB 大小范围内，提供 URL。

产出

生成的文件会被存储并作为签名下载URL返回。

Hitem3D 2.0 API：常见问题

Hitem3D 2.0 API 收费多少？

在 EmpirioLabs，Hitem3D 2.0 按量计费：1536 纹理 $2.80 按请求; 1536 Pro 纹理 $3.60 按请求; 1536年白色型号 $1.60 按请求; 1536 Pro 白色型号 $2.40 按请求。本页的实时价格表始终与 API 的实际计费一致。

Hitem3D 2.0 使用哪个端点？

Hitem3D 2.0 通过 api.empiriolabs.ai 上的 POST /v1/3d/generations 提供，使用标准的 Bearer 令牌认证。

集成之前可以在浏览器里试用 Hitem3D 2.0 吗？

可以。EmpirioLabs Playground在浏览器中以与 API 相同的参数运行 Hitem3D 2.0，你可以在写代码之前先测试提示词。

如何获取 Hitem3D 2.0 API 密钥？

创建 EmpirioLabs 账户，然后在控制台的 API Keys生成密钥。计费使用按量付费的额度，只为实际发出的请求付费。

Hitem3D 2.0 API