INFO

Meshy 3D API

The Create Task Endpoint for Meshy 3D Model Generation!

Supported task_type: image-to-3d and text-to-3d.

text-to-3D runs in two stages: preview builds the mesh, then refine adds textures — pass the task_id returned by your preview task as preview_task_id.

image-to-3D: 0.24 without texture, $0.42 at 8K

text-to-3D: 0.12 per refine

The result is a .glb model file hosted on our servers and kept for 3 days.

Request

Header Params

Body Params application/json

Examples

text-to-3dimage-to-3d

{
    "model": "meshy",
    "task_type": "text-to-3d",
    "input": {
        "mode": "preview",
        "prompt": "a small ceramic teapot, simple shape",
        "art_style": "realistic",
        "should_remesh": true
    },
    "config": {
        "service_mode": "public"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

image-to-3dtext-to-3d

{
    "code": 200,
    "data": {
        "task_id": "42247ddb-bcf1-4b2e-b2f4-2b2870df1469",
        "model": "meshy",
        "task_type": "image-to-3d",
        "status": "pending",
        "config": {
            "service_mode": "public",
            "webhook_config": {
                "endpoint": "",
                "secret": ""
            }
        },
        "input": {
            "image_url": "https://img.theapi.app/temp/e7da0939-1b67-44fb-a587-5ea1601d0aeb.png",
            "should_texture": true,
            "should_remesh": true,
            "result_formats": [
                "glb"
            ]
        },
        "output": null,
        "meta": {
            "created_at": "2026-09-29T09:22:17.153849693Z",
            "started_at": "0001-01-01T00:00:00Z",
            "ended_at": "0001-01-01T00:00:00Z",
            "usage": {
                "type": "point",
                "frozen": 3600000,
                "consume": 0
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "message": "",
            "detail": null
        }
    },
    "message": "success"
}

Meshy Create Task

Meshy 3D API#

Request

Request Code Samples

Responses

Meshy 3D API