curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "meshy-6-text-to-3d",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A worn leather explorer backpack with brass buckles, canvas straps, realistic stitching, game-ready asset",
"mode": "full",
"topology": "triangle",
"target_polycount": 30000,
"should_remesh": true,
"symmetry_mode": "auto",
"enable_pbr": true,
"pose_mode": "",
"enable_prompt_expansion": true,
"enable_safety_checker": true
}
}
'{
"code": 200,
"data": {
"task_id": "<string>",
"status": "not_started",
"created_time": "2023-11-07T05:31:56Z"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Meshy
Meshy 6 3D
Meshy 6 3D API 从文本、单张图像或同一物体的 1–4 张图像生成 3D 网格。可请求纹理、PBR 贴图、人形骨骼绑定和预设动画，文档列出的输出格式包括 GLB、FBX、OBJ、USDZ 和 STL。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "meshy-6-text-to-3d",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A worn leather explorer backpack with brass buckles, canvas straps, realistic stitching, game-ready asset",
"mode": "full",
"topology": "triangle",
"target_polycount": 30000,
"should_remesh": true,
"symmetry_mode": "auto",
"enable_pbr": true,
"pose_mode": "",
"enable_prompt_expansion": true,
"enable_safety_checker": true
}
}
'{
"code": 200,
"data": {
"task_id": "<string>",
"status": "not_started",
"created_time": "2023-11-07T05:31:56Z"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- meshy-6-text-to-3d - 从提示词生成 3D 模型
- meshy-6-image-to-3d - 从一张图像生成 3D 模型
- meshy-6-multi-image-to-3d - 从 1-4 张图像生成 3D 模型
必填参数
- model：
meshy-6-text-to-3d、meshy-6-image-to-3d或meshy-6-multi-image-to-3d - input.prompt：
meshy-6-text-to-3d必填 - input.image_urls：图像模型必填。
meshy-6-image-to-3d只能传 1 张图像，meshy-6-multi-image-to-3d传 1-4 张图像
可选参数
- mode：仅文生 3D。
preview或full。默认full - seed：仅文生 3D。用于复现结果的整数种子
- topology：
quad或triangle。默认triangle - target_polycount：目标多边形数量。默认
30000 - should_remesh：是否启用重新网格化阶段。默认
true - symmetry_mode：
off、auto或on。默认auto - should_texture：仅图像模型。是否生成纹理。默认
true - enable_pbr：生成金属度、粗糙度、法线等 PBR 贴图
- pose_mode：
a-pose、t-pose，或空字符串表示不指定姿势 - enable_prompt_expansion：仅文生 3D。是否自动扩写提示词
- texture_prompt：用于引导纹理的文本提示词
- texture_image_url：用于引导纹理的图像 URL
- enable_rigging：是否为人形角色绑定骨骼
- rigging_height_meters：启用骨骼绑定时使用的角色身高。默认
1.7 - enable_animation：是否应用动画预设。需要启用骨骼绑定
- animation_action_id：Meshy 动画预设 ID。默认
1001 - enable_safety_checker：是否启用输入安全检查。默认
true - callback_url：可选，任务完成通知的 Webhook URL
输出
任务结果可能包括：model_glbthumbnailmodel_urls：可用时包括glb、fbx、obj、usdz、blend和stltexture_urls：基础色及可选的 PBR 纹理文件- 启用动画时包括
animation_glb和animation_fbx - 启用骨骼绑定时包括
rigged_character_glb和rigged_character_fbx - 启用骨骼绑定时包括
basic_animations
label、file_url、file_type、format、content_type、file_name 和 file_size。
注意事项
meshy-6-image-to-3d在image_urls中只接受一张图像。meshy-6-multi-image-to-3d接受 1-4 张图像。这些图像应从不同角度展示同一物体。- API 返回异步任务状态。请轮询统一的任务状态接口，或使用
callback_url。
授权
所有 API 接口都需要 Bearer Token 认证。
创建 API Key：登录 PoYo，进入 仪表盘 → API 密钥（poyo.ai/zh/dashboard/api-key），点击创建 Key。
在请求头中添加：
Authorization: Bearer YOUR_API_KEY
请求体
application/json
响应
任务提交成功
Show child attributes
Show child attributes