Hyper3D Gen2 API：价格、Playground 与文档

Q: Hyper3D Gen2 使用哪个端点？

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

关于 Hyper3D Gen2

Rodin Gen-2 engine that turns a text prompt or up to five reference images into production 3D assets with PBR materials and quad or raw meshes.

也称为 Deemos Hyper3D Gen2

image to 3dtext to 3dpbr materialsquad meshseed control

Hyper3D Gen2 规格

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

Hyper3D Gen2 API 价格

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

类型

规格

价格

Per generation

per request

$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	-	-	Text description of the object, in English, up to 400 characters. Optional when input images are provided.
image	array	-	-	Up to five input images of the object. Multiple images act as multi-view references.
material	enum	PBR	PBR, Shaded, All, None	Texture output: PBR maps, Shaded baked lighting, All for both, or None for an untextured white mesh.
mesh_mode	enum	Quad	Quad, Raw	Quad outputs a quad mesh; Raw outputs a triangle mesh with higher face-count ceilings.
subdivision_level	enum	-	high, medium, low	Preset face-count level for the chosen mesh mode. Ignored when quality_override is set.
quality_override	integer	-	500 到 1000000	Custom face count. Raw meshes accept 500 to 1,000,000; Quad meshes 1,000 to 200,000.
hd_texture	boolean	false	-	Generate HD textures.
high_pack	boolean	false	-	Upgrade texture maps to 4K (2K without it).
use_original_alpha	boolean	false	-	Preserve transparent regions of the input image.
ta_pose	boolean	false	-	Force humanoid subjects into a standard T or A binding pose.
seed	integer	-	0 到 65535	Seed in [0, 65535]. Same seed gives similar, not identical, results.

须知

Generates one 3D asset per request from a text prompt (English, up to 400 characters), one to five reference images, or both. Billing is a flat rate per generated model.

Controls

Materials: PBR, Shaded, both, or an untextured white mesh.
Quad or raw triangle meshes with preset subdivision levels or an exact face count (up to 1,000,000 raw or 200,000 quad).
glb, obj, usdz, fbx, or stl output, optional HD and 4K textures, transparent-alpha preservation, T/A pose for humanoids, and a seed control.

Input limits

Images: jpg, jpeg, or png, under 4096x4096 px and 30 MB each.

输出

The generated file is stored and returned as a signed download URL.

Hyper3D Gen2 API：常见问题

Hyper3D Gen2 API 收费多少？

在 EmpirioLabs，Hyper3D Gen2 按量计费：Per generation $0.80 per request。本页的实时价格表始终与 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