API 有速率限制吗？

速率限制和并发量取决于账户类型或企业协议。高吞吐量团队可与 Hyper3D 沟通生产能力和集成需求。

我可以将通过 API 生成的 3D 资产用于商业用途吗？

商业用途取决于您的套餐、条款，以及您的提示词或源参考内容所对应的权利。团队应选择与其生产需求相匹配的 API 访问级别。

生产级规模
3D 资产生成
通过 API

使用 Rodin Gen-2 端点，从您自己的产品或生产流水线提交文本转 3D、图像转 3D、状态查询、
下载和贴图任务。

curl https://api.hyper3d.com/api/v2/rodin\-H"Authorization: Bearer $RODIN_API_KEY"\-F"tier=Gen-2" \-F"prompt=stylized sci-fi crate" \-F"geometry_file_format=glb"

Hyper3D API 快速入门

面向多样化使用场景并持续优化，我们的 API 提供流畅无缝的体验。

快速开始

借助简洁的 API 和清晰的文档，几分钟即可上手运行。

用量管理

实时监控用量、管理配额并追踪性能。

集成

在现有工作流中轻松连接常用工具和平台。

文本、图像、纹理

一个 API 接口覆盖核心 3D 生成工作流。

流水线就绪

导出适用于网页、游戏、AR、DCC 和制作审片的资产。

异步状态流

提交任务、检查进度，然后下载生成的文件。

Hyper3D API 能力

以卓越速度大规模生成、贴图并优化 3D 资产。

示例


                          curl  --fail-with-body \     --request  POST 'https://api.hyper3d.com/api/v2/rodin' \     --header  "Authorization: Bearer ${RODIN_API_KEY}" \     --form  'prompt=A small wooden treasure chest with brass trim' \     --form  'tier=Gen-2.5-Medium' \     --form  'mesh_mode=Raw' \     --form  'quality=medium' \     --form  'geometry_file_format=glb' \     --form  'material=PBR'


                          import  os   import  requests       response  = requests.post(        "https://api.hyper3d.com/api/v2/rodin",       headers ={"Authorization": f"Bearer {os.environ['RODIN_API_KEY']}"},        data={            "prompt": "A small wooden treasure chest with brass trim",            "tier": "Gen-2.5-Medium",            "mesh_mode": "Raw",            "quality": "medium",            "geometry_file_format": "glb",            "material": "PBR",        },        timeout=60,    )       response .raise_for_status()   print (response.json())


                           {     "message" : "Submitted.",     "uuid" : "<task_uuid>",     "jobs" : {       "uuids" : ["<job_uuid>"],       "subscription_key" : "<subscription_key>"      },     "consumed" : 0.5    }

示例


                          curl  --fail-with-body \     --request  POST 'https://api.hyper3d.com/api/v2/rodin' \     --header  "Authorization: Bearer ${RODIN_API_KEY}" \     --form  'images=@./input.png' \     --form  'prompt=Preserve the silhouette and produce symmetric geometry' \     --form  'tier=Gen-2.5-Medium' \     --form  'mesh_mode=Raw' \     --form  'quality=medium' \     --form  'geometry_file_format=glb' \     --form  'material=PBR'


                          import  os   import  requests        with open("input.png", "rb") as image:       response  = requests.post(            "https://api.hyper3d.com/api/v2/rodin",           headers ={"Authorization": f"Bearer {os.environ['RODIN_API_KEY']}"},           files ={"images": image},            data={                "prompt": "Preserve the silhouette and produce symmetric geometry",                "tier": "Gen-2.5-Medium",                "mesh_mode": "Raw",                "quality": "medium",                "geometry_file_format": "glb",                "material": "PBR",            },            timeout=60,        )       response .raise_for_status()   print (response.json())


                           {     "message" : "Submitted.",     "uuid" : "<task_uuid>",     "jobs" : {       "uuids" : ["<job_uuid>"],       "subscription_key" : "<subscription_key>"      },     "consumed" : 0.5,     "prompt" : "Preserve the silhouette and produce symmetric geometry"    }

示例


                          curl  --fail-with-body \     --request  POST 'https://api.hyper3d.com/api/v2/rodin_texture_only' \     --header  "Authorization: Bearer ${RODIN_API_KEY}" \     --form  'image=@./reference.png' \     --form  'model=@./model.glb' \     --form  'prompt=Weathered bronze with subtle green patina' \     --form  'material=PBR' \     --form  'resolution=High'


                          import  os   import  requests        with open("reference.png", "rb") as image, open("model.glb", "rb") as model:       response  = requests.post(            "https://api.hyper3d.com/api/v2/rodin_texture_only",           headers ={"Authorization": f"Bearer {os.environ['RODIN_API_KEY']}"},           files ={"image": image, "model": model},            data={                "prompt": "Weathered bronze with subtle green patina",                "material": "PBR",                "resolution": "High",            },            timeout=60,        )       response .raise_for_status()   print (response.json())


                           {     "message" : "Submitted.",     "uuid" : "<task_uuid>",     "jobs" : {       "uuids" : ["<job_uuid>"],       "subscription_key" : "<subscription_key>"      },     "consumed" : 0.5    }

企业级 API 访问

解锁高级性能、专属端点和可信赖的安全保障。

企业级性能

保证最高速率限制、并发能力和任务优先级，提供 99.9% 正常运行时间 SLA。

查看套餐

访问企业专属 API 端点。

查看套餐

经认证的安全合规

通过 ISO/IEC 27001 和 GDPR 认证，提供企业级信息安全保障。

查看套餐

资产无限期保留

无限期保留 API 生成的资产。

查看套餐

各等级 API 访问权限

比较不同 Hyper3D API 等级的速率限制、并发能力和访问权限。

能力	商业版	企业版热门
API 访问	已包含	定制
API 身份验证	API 密钥 / Bearer 令牌	API 密钥 / 定制配置
支持的 API	Rodin Generation、Gen-2、Gen-2.5、BANG!、Texture Generation、Status、Download、Balance	Business API + 定制启用
生成模式	图像转 3D、文本转 3D、多图生成	同上，另含合同约定的定制服务
可用模型等级	Sketch、Regular、Detail、Smooth、Gen-2、Gen-2.5 等级	同上，另含合同约定的访问权限
积分成本	每次生成最低 0.5 积分；HighPack +1 积分；Gen-2.5 Extreme-High 1 积分	定制条款
状态查询 / 下载 / 余额 API	无需额外积分	无需额外积分 / 定制条款
数据保留	7 天	默认 7 天，可按协议定制
API 密钥管理	创建、管理和撤销 API 密钥	专属接入指导 / 定制配置
速率限制	未公开说明	按协议定制
支持 / SLA	标准支持	合同约定的支持 / SLA
自定义端点		按协议定制
安全 / 合规条款	标准政策	合同约定的安全审查 / 条款