Skip to main content
PiAPI
Workspace
PiAPI

Resources

CLIAPI DocsBilling
Credits$—
Theme

3d models

Meshy 3D API / 用于图像转 3D 和文本转 3D 生成

使用 通过 PiAPI 提交异步 3D 生成任务，并获取完成的 GLB 资产。

立即开始！

Meshy 3D API 价格

通过 PiAPI 按成功生成次数付费。

Image to 3D mesh

$0.24

  • Mesh-only GLB output

Image to 3D textured

from $0.36

  • 2k — $0.36
  • 4k — $0.36
  • 8k — $0.42

Text preview → refine

from $0.24

  • Preview — $0.24
  • Refine 2K/4K — $0.12
  • Refine 8K — $0.18
Get StartedAPI docsFull pricing

Meshy 3D API 功能

图像转 3D 生成

发送图片 URL，选择仅网格输出，或选择纹理分辨率为 2K、4K 或 8K 的带纹理输出。

文本转 3D 预览

使用提示词启动文本转 3D 预览任务，完成后使用其 PiAPI task_id 进行精修。

精修已完成的预览

精修请求接受 preview_task_id，并通过相同的任务轮询流程返回完成的 GLB 模型。

异步任务 API

向 PiAPI 提交任务，轮询任务状态或使用 webhook，然后从 output.model_file 读取完成的模型。

快速开始

Create your API key

Sign up and grab an API key from the PiAPI workspace — free credits are included on sign-up.

Top up credits

Add credits on the billing page when you are ready to scale beyond the free tier.

Call the API

POST your first task following the API docs, then poll the task until the result is ready.

Iterate in the playground

Prototype prompts and settings in the the playground above before wiring them into your product.

Create a task

curl -X POST 'https://api.piapi.ai/api/v1/task' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "meshy",
  "task_type": "image-to-3d",
  "input": {
    "image_url": "YOUR_IMAGE_URL",
    "should_texture": true,
    "texture_resolution": "2k"
  }
}'

Retrieve the result

curl 'https://api.piapi.ai/api/v1/task/{task_id}' \
  -H 'X-API-Key: YOUR_API_KEY'

model_file

Pricing

  • default: $0.36 / generation
  • mesh-only: $0.24 / generation
  • 2k: $0.36 / generation
  • 4k: $0.36 / generation
  • 8k: $0.42 / generation
Get StartedAPI docs

Meshy 3D API 常见问题

文本转 3D 的预览和精修如何工作？

使用 mode=preview 创建预览，等待完成后，将其 PiAPI task_id 作为 preview_task_id，并以 mode=refine 发送请求。

图像转 3D 请求如何计费？

费用估算随 should_texture 和 texture_resolution 变化。工作区会在提交前显示所选配置的估算费用。

在哪里可以找到请求结构？

请查看本页链接的 Meshy 创建任务和获取任务 API 文档。

More questions? See the API docs.