Tripo · 3D

Tripo v3.1 API

Generate a 3D model (GLB) from an image or a text prompt. Models: hunyuan3d-3.1 (image-to-3D), tripo-v3.1, meshy-6 and meshy-7 (text- or image-to-3D). For image-to-3D, first make an image with image_generate and pass its URL as imageUrl. Generating a humanoid character you intend to rig? Call model_guide first — it must be in an open A-pose (arms out from the torso, legs apart) or the rig will fail. Async: returns a jobId — poll GET /api/v1/jobs/:id until it succeeds, then read result.mesh (or modelUrl).

Available through Sorceress API

Use with an AI agentManage API keys
Tripo v3.1 model artwork

Using Tripo v3.1 in your workflow

Sorceress brings Tripo models into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.

  • Build a game asset pipeline around geometry, rigging or motion.
  • Use the documented input format for this particular 3D workflow.

Pricing and availability

Cost varies by model/mode/options (e.g. Hunyuan 30, Tripo 45–50, Meshy 45). Charged in credits only on success.. Successful work is billed in Sorceress credits. Defaults and optional inputs can affect the total.

Texture (image-to-3D)

no30 credits

standard40 credits

HD (default)50 credits

Texture (text-to-3D)

no20 credits

standard35 credits

HD (default)45 credits

Inputs and supported options

modelstring · required

3D model. One of: hunyuan3d-3.1, tripo-v3.1, meshy-6, meshy-7. hunyuan3d-3.1 is image-to-3D only; tripo-v3.1, meshy-6 and meshy-7 also support text-to-3D.

promptstring · optional

Text description for text-to-3D (tripo-v3.1 / meshy-6 / meshy-7 only). For a humanoid character you intend to rig, describe an OPEN A-POSE — arms lowered ~40° out from the shoulders with a gap at each armpit, legs hips-width apart, nothing in the hands, no base under the feet. Arms-down poses fuse the limbs to the torso and cannot be rigged. Call model_guide for the full clause to paste.

imageUrlstring · optional

https image URL for image-to-3D (required for hunyuan3d-3.1). Tip: generate one first with image_generate, then pass its URL here. For characters, the reference must be a full-body front view in an open A-pose on a plain background — the mesh copies the silhouette (see model_guide).

imageUrlsarray · optional

Multiple https image URLs for multi-view (tripo-v3.1 / meshy-6 / meshy-7). Up to 4, ordered front, left, back, right.

paramsobject · optional

Model-specific options that can affect cost (e.g. Meshy should_texture/texture_resolution 2k|4k|8k/should_remesh/target_polycount/topology/ultra_mode; Tripo texture no|standard|HD, quad, geometry_quality).

API request template

Replace placeholders and choose valid values from the input contract. 

POST /api/v1/tools/model_generate
Authorization: Bearer $SORCERESS_API_KEY
Content-Type: application/json

{
  "model": "tripo-v3.1"
}
Read the endpoint reference →

Completion, results and billing

Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.

Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.