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"
}
}Meshy
Meshy 6 3D
Meshy 6 text-to-3D, image-to-3D, and multi-image-to-3D generation
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"
}
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the result through the unified Query Task Status endpoint.
Meshy 6 3D
Meshy 6 3D supports text-to-3D, single image-to-3D, and multi-image-to-3D generation through three public model IDs.Available Models
- meshy-6-text-to-3d - Generate a 3D model from a prompt
- meshy-6-image-to-3d - Generate a 3D model from one image
- meshy-6-multi-image-to-3d - Generate a 3D model from 1-4 images
Required Parameters
- model:
meshy-6-text-to-3d,meshy-6-image-to-3d, ormeshy-6-multi-image-to-3d - input.prompt: Required for
meshy-6-text-to-3d - input.image_urls: Required for image models. Use exactly 1 image for
meshy-6-image-to-3d, and 1-4 images formeshy-6-multi-image-to-3d
Optional Parameters
- mode: Text-to-3D only.
previeworfull. Default isfull - seed: Text-to-3D only. Integer seed for reproducible results
- topology:
quadortriangle. Default istriangle - target_polycount: Target polygon count. Default is
30000 - should_remesh: Whether to enable the remesh phase. Default is
true - symmetry_mode:
off,auto, oron. Default isauto - should_texture: Image models only. Whether to generate textures. Default is
true - enable_pbr: Generate PBR maps such as metallic, roughness, and normal maps
- pose_mode:
a-pose,t-pose, or an empty string for no specific pose - enable_prompt_expansion: Text-to-3D only. Whether to expand the prompt automatically
- texture_prompt: Text prompt to guide texturing
- texture_image_url: Image URL to guide texturing
- enable_rigging: Whether to rig humanoid characters
- rigging_height_meters: Character height used when rigging is enabled. Default is
1.7 - enable_animation: Whether to apply an animation preset. Requires rigging
- animation_action_id: Meshy animation preset ID. Default is
1001 - enable_safety_checker: Whether to enable input safety checking. Default is
true - callback_url: Optional webhook URL for task completion notification
Output
The task result may include:model_glbthumbnailmodel_urls:glb,fbx,obj,usdz,blend, andstlwhen availabletexture_urls: base color and optional PBR texture filesanimation_glbandanimation_fbxwhen animation is enabledrigged_character_glbandrigged_character_fbxwhen rigging is enabledbasic_animationswhen rigging is enabled
label, file_url, file_type, format, content_type, file_name, and file_size when available.
Notes
meshy-6-image-to-3daccepts exactly one image inimage_urls.meshy-6-multi-image-to-3daccepts 1-4 images. Images should show the same object from different angles.- The API returns asynchronous task status. Poll the unified task status endpoint or use
callback_url.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json