models/Meshy/Meshy T2.5 Image to 3D
M
Meshy

Meshy T2.5 Image to 3D

3d
Compare

Meshy T2.5 is Meshy's latest Smart Topology model. It converts a single image into a clean, triangle-only 3D mesh with natively separated parts, with a target polycount of up to 30,000 triangles (default 15,000). Compared with Meshy T2, it produces sharper detail and keeps shape and proportions closer to the input image, at the cost of longer generation times; optional textures, PBR maps and humanoid rigging are supported.

MODALITIES
text

Meshy T2.5 Image to 3D (meshy/t2.5/image-to-3d) is a 3d model from Meshy. Pricing via AIgateway: see pricing table. Call it via https://api.aigateway.sh/v1/3d/generations — set model="meshy/t2.5/image-to-3d".

model · meshy/t2.5/image-to-3d

Use this model

model: meshy/t2.5/image-to-3d
curl https://api.aigateway.sh/v1/3d/generations \
  -H "Authorization: Bearer $AIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"meshy/t2.5/image-to-3d","prompt":"A low-poly treasure chest"}'
API schema

Call Meshy T2.5 Image to 3D from any OpenAI SDK

POST https://api.aigateway.sh/v1/3d/generations·Content-Type: application/json·Auth: Bearer sk-aig-...

Request body

json
{
  "model": "meshy/t2.5/image-to-3d",
  "prompt": "A low-poly treasure chest, game asset",
  // optional "image_url" to reconstruct from a reference image
  "webhook_url": "https://your.app/webhooks/aigateway"  // optional
}

// Response is an async job — poll /v1/jobs/<id> until status === "completed".

Response

json
{
  "id": "job_abc123",
  "status": "queued",        // queued | processing | completed | failed
  "model": "meshy/t2.5/image-to-3d",
  "created": 1776947082
}

// After completion (GET /v1/jobs/job_abc123):
{
  "id": "job_abc123",
  "status": "completed",
  "result": {
    "url": "https://media.aigateway.sh/3d/abc123.glb",
    "format": "glb"
  }
}

Quickstart

import os, requests

r = requests.post(
    "https://api.aigateway.sh/v1/3d/generations",
    headers={"Authorization": f"Bearer {os.environ['AIGATEWAY_API_KEY']}"},
    json={
        "model": "meshy/t2.5/image-to-3d",
        "prompt": "A low-poly treasure chest"
    },
)
print(r.json())

Errors

401authentication_errorInvalid or missing API key
402insufficient_creditsWallet empty (PAYG only)
404not_foundUnknown model or endpoint
429rate_limit_errorOver per-minute limit — see Retry-After header
500server_errorUpstream provider failed (retryable)
503service_unavailableUpstream saturated (retryable)
Full docs →API reference →OpenAPI spec →llms.txt →

Frequently asked questions

What is Meshy T2.5 Image to 3D?
Meshy T2.5 is Meshy's latest Smart Topology model. It converts a single image into a clean, triangle-only 3D mesh with natively separated parts, with a target polycount of up to 30,000 triangles (default 15,000). Compared with Meshy T2, it produces sharper detail and keeps shape and proportions closer to the input image, at the cost of longer generation times; optional textures, PBR maps and humanoid rigging are supported. It is a 3d model from Meshy, accessible via AIgateway's OpenAI-compatible API at slug meshy/t2.5/image-to-3d.
How much does Meshy T2.5 Image to 3D cost via AIgateway?
Pass-through pricing. See the pricing panel on this page for exact rates.
How do I call Meshy T2.5 Image to 3D from my code?
Point the OpenAI SDK at https://api.aigateway.sh/v1 with your AIgateway key and set model to "meshy/t2.5/image-to-3d". The request and response shapes match OpenAI exactly.
Does Meshy T2.5 Image to 3D support streaming, tool calling, vision, and JSON mode?
Streaming — no. Tool calling — no. Vision — no. JSON mode — no. Prompt caching — no.
Can I bring my own Meshy API key (BYOK)?
Yes. Attach a Meshy key in your AIgateway dashboard and this model flips to pass-through — you pay Meshy directly and AIgateway adds no platform fee on those calls.