Hyper3D Gen2 API：价格、Playground 与文档

Q: Hyper3D Gen2 使用哪个端点？

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

关于 Hyper3D Gen2

Rodin Gen-2 引擎，可将文本提示或最多五张参考图像转化为带有 PBR 材质和四边形或原始网格的生产 3D 资产。

也称为 Deemos Hyper3D Gen2

image to 3dtext to 3dpbr materialsquad meshseed control

Hyper3D Gen2 规格

模型 ID: hyper3d-gen2
开发方: Deemos
类别: 3D生成
发布日期: 2025年10月1日
输入: 文本图像
输出: 3D
区域: Malaysia
端点: POST/v1/3d/generations
备用模型 ID: deemos/hyper3d-gen2hyper3d-gen2-260112rodin-gen2

Hyper3D Gen2 API 价格

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

类型

规格

价格

每代人

按请求

$0.80

在完整价格页比较

如何调用 Hyper3D Gen2 API

Hyper3D Gen2 通过 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": "hyper3d-gen2",
    "prompt": "Describe what you want Hyper3D Gen2 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": "hyper3d-gen2",
        "prompt": "Describe what you want Hyper3D Gen2 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)

Hyper3D Gen2 API 完整参考

Hyper3D Gen2 API 参数

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

参数	类型	默认值	范围 / 值	描述
prompt	string	-	-	物品的文字描述，英文，最多400字符。提供输入图片时为可选。
image	array	-	-	最多可输入五张物体图像。多张图片作为多视图参考。
material	enum	PBR	PBR, Shaded, All, None	纹理输出：PBR贴图、着色烘焙光照，两者皆可用，或无纹理白色网格均为无。
mesh_mode	enum	Quad	Quad, Raw	四边形输出四边形网格;RAW输出的是三角形网格，面数上限更高。
subdivision_level	enum	-	high, medium, low	为所选网格模式预设面数级别。设置quality_override时会被忽略。
quality_override	integer	-	500 到 1000000	自定义面孔计数。原始网格接受500到1,000,000;四边形网格为1000到20万。
file_format	enum	glb	glb, obj, usdz, fbx, stl	生成模型的3D文件格式。
hd_texture	boolean	false	-	生成高清纹理。
high_pack	boolean	false	-	把纹理贴图升级到4K（不升级则是2K）。
use_original_alpha	boolean	false	-	保留输入图像的透明区域。
ta_pose	boolean	false	-	强制类人生物进入标准的T或A型绑定姿势。
seed	integer	-	0 到 65535	种子在[0， 65535]。同一种种子得到的结果相似，但不完全相同。

须知

每个请求生成一个3D资产（英文，最多400字符）、一到五张参考图片，或两者兼有。计费是每个生成模型的固定费率。

控制

材质：PBR、Shaded、两者兼用，或无纹理的白色网格。
四边形或原始三角形网格，带有预设细分层级或精确面计数（最高可达1,000,000原始或200,000四边形）。
glb、obj、usdz、fbx 或 stl 输出，可选的高清和 4K 纹理，透明 alpha 保留，人形的 T/A 姿势，以及种子控制。

输入限制

图片：jpg、jpeg 或 png，分辨率在 4096x4096 像素和 30 MB 大小下。

产出

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

Hyper3D Gen2 API：常见问题

Hyper3D Gen2 API 收费多少？

在 EmpirioLabs，Hyper3D Gen2 按量计费：每代人 $0.80 按请求。本页的实时价格表始终与 API 的实际计费一致。

Hyper3D Gen2 使用哪个端点？

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

集成之前可以在浏览器里试用 Hyper3D Gen2 吗？

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

如何获取 Hyper3D Gen2 API 密钥？

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

Hyper3D Gen2 API