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.