API功能
我们的 API 经常在无数领域和用例中使用。无论是文本到 3D、图像到 3D 还是 AI 纹理,我们的 API 都在不断发展,为用户创造最无缝的体验。
文本到 3D
通过自然语言描述生成可投入生产的 3D 资产。支持风格控制、材质选项与模型尺寸约束,适用于快速原型或大规模管线。
curl -X POST https://api.meshy.ai/openapi/v1/text-to-3d \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "retro sci-fi robot with glossy paint",
"style": "stylized",
"target_poly_count": 50000
}'
图像转 3D
利用单张或多张图像生成 3D 资产。可启用 PBR、重网格与纹理选项,一次请求完成完整资产。
import requests
payload = {
"image_url": "https://example.com/car.png",
"enable_pbr": True,
"should_remesh": True,
"should_texture": True
}
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.post(
"https://api.meshy.ai/openapi/v1/image-to-3d",
headers=headers,
json=payload,
)
response.raise_for_status()
重网格化
对模型进行自动减面与拓扑优化,保留关键细节。支持自定义面数、法线重建与部件拆分。
{
"source_asset_id": "asset_123",
"target_poly_count": 15000,
"preserve_uv": true,
"hard_edge_threshold": 45
}
AI 纹理化
上传网格或原始纹理,生成 PBR 套件。支持材质提示词、分辨率自定义与贴图自动整理。
"maps": ["baseColor", "metallic", "roughness", "normal"], "prompt": "weathered bronze statue with moss", "resolution": 2048
绑定与动画
生成标准或自定义骨骼动画。提供权重自动调整、面部绑定与动作库组合。
{
"asset_id": "character_alpha",
"skeleton": "humanoid",
"include_face": true,
"animation_set": ["walk", "idle", "jump"]
}
Webhook 支持
订阅任务状态事件,与现有工作流关联。每个阶段都会推送状态与回调地址,方便做异步处理。
{
"event": "task.completed",
"task_id": "task_456",
"result_url": "s3://bucket/output.zip",
"duration_ms": 124000
}
企业级 API 访问
解锁高级性能,独家端点,以及您可以信赖的安全性。
使用案例
我们的 API 定期在各种领域和用例中使用。无论是文本转 3D、图像转 3D 还是 AI 纹理,我们都在不断发展,为用户创造流畅体验。
按等级的 API 访问
比较 Meshy API 各层的速率限制、并发性与访问级别。根据团队规模和需求灵活选择。
| 特征 | 免费 | 专业 | 工作室 | 企业 |
|---|---|---|---|---|
| 每秒请求 | — | 20 | 20 | 100+(可定制) |
| 并发队列任务 | — | 最多 10 | 最多 20 | 50+(可定制) |
| 优先级别 | — | 默认 | 比专业更高 | 最高(最快模型访问) |
| 资产保留 | — | 3 天数 | 3 天数 | 永久 |
| 信用卡自动充值 | — | — | ✓ | ✓ |
| 自定义端点 | — | — | — | ✓ |
| 直接账户支持 | — | — | — | ✓ |
| SLA 保证 | — | — | — | 99.9% 正常运行时间 |
| 安全认证 | — | — | — | ISO 27001 / SOC2 Type II / GDPR |
FAQ
覆盖 Meshy API 集成、用量、定价与安全的常见问题。如果需要更多帮助,可随时联系团队。
我应该如何开始?+
创建账户并生成 API Key,使用快速开始指南配置 SDK 或 Postman。参考文档完成第一次请求。
API 使用的价格是如何定价的?+
Meshy API 按积分计费,不同功能消耗不同积分。专业与企业计划支持批量采购与自动补充。
我需要更多积分,是否提供定制方案?+
企业计划支持按月大额积分、定制配额与专属计费。请联系销售获取个性化方案。
API 上是否有速率限制?+
所有计划都设有默认限流。企业用户可获得更高并发与专属队列,满足复杂工作流。
Meshy 会保留 API 生成的资产吗?+
不同计划提供 3 至 30 天的默认保留时间。企业计划可永久保存,并支持加密传输。
可以集成其他 3D 软件吗?+
官方插件支持 Blender、Unity、Unreal、Godot、Maya、3ds Max 等工具,并提供开放 API 供自定义。