QUADY3D API / MODEL REFERENCE

Choose your model.
Know its settings.

Compare 14 model IDs and their supported text or image inputs. Use the same account, quote and recovery flow with MCP, a Skill or an SDK.

This reference describes the API contract. Check the authenticated models endpoint for current availability and settings, then request a quote for your exact input. Default estimates below are not a fixed price.

From your account to a model file

Check your account. Sign in and choose a credit pack or subscription when you need credits and download access. Wait for the payment to appear in your account.
Create a dedicated Key. Open Connected apps and select the permissions your client needs. Key limits cap spending; they do not add credits or unlock downloads.
Read account and models. Verify balance, download access and Key limits with GET /account. Select an available model and its parameter_schema with GET /models.
Quote and save the request. Use POST /quotes, review the exact cost, then save the body and action ID before submitting with quote_id and max_credits.
Recover and deliver. Keep the original task ID and request. Read the completed job’s actual assets and save the owned result. See the recovery guide and complete TypeScript or Python examples.

Model support at a glance

Text takes a prompt. Image takes one selected PNG, JPEG or WebP up to 8 MiB, uploaded through POST /uploads. API paths are relative to /api/v1.

Model / API ID	Text	Image	Default estimate
Tripo H3.1`tripo-h3-1`	Supported	Supported	Text: 20 creditsImage: 30 credits
Rodin 2.5 Fast`rodin-2-5-fast`	Supported	Supported	Text: 10 creditsImage: 10 credits
Hunyuan3D 3.1 Rapid`hunyuan-3-1-rapid`	Supported	Supported	Text: 23 creditsImage: 23 credits
Hunyuan3D 3.0`hunyuan-3`	Supported	Supported	Text: 63 creditsImage: 63 credits
Hunyuan3D 3.1 Pro`hunyuan-3-1-pro`	Supported	Supported	Text: 38 creditsImage: 38 credits
Rodin 2.5`rodin-2-5`	Supported	Supported	Text: 40 creditsImage: 40 credits
Tripo P2`tripo-p2`	Supported	Supported	Text: 110 creditsImage: 110 credits
Meshy 7.1`meshy-7-1`	Supported	Supported	Text: 144 creditsImage: 120 credits
GPT-6 Astra`gpt-6-astra`	Supported	Supported	Text: 800 creditsImage: 800 credits
Hunyuan3D 2 Mini`hunyuan-2-mini`	—	Supported	Image: 12 credits
TRELLIS.2`trellis-2`	—	Supported	Image: 20 credits
Pixal3D`pixal3d`	—	Supported	Image: 30 credits
Seed3D 2.0`seed3d-2`	—	Supported	Image: 35 credits
Hi3D 3.0`hi3d-3`	—	Supported	Image: 210 credits

API operations have their own scope.

The public API supports text to 3D and single image to 3D. Multi-view, sketch, standalone PBR generation, remeshing, conversion, standalone rigging and Blender scene control are separate workflows. A model’s PBR or rigging setting applies only to that generation request. Explore the model directory for browser workflows.

Discover before you generate

Filter by operation, then use the returned ID and schema. This request reads model information without starting a generation.

cURL

curl --fail-with-body \
  "https://quady3d.com/api/v1/models?operation=image-to-3d" \
  -H "Authorization: Bearer $QUADY3D_API_KEY"

Inputs, defaults and constraints

All listed model parameters are optional. Omitted values use the schema defaults. Unknown fields or invalid combinations are rejected; use public parameter names below rather than upstream supplier fields.

Tripo H3.1tripo-h3-1Text + image

Explore Tripo H3.1 examples and browser workflows →

text-to-3d

Use inputs.prompt, up to 1000 characters.

Parameter	Type / default	Allowed values and limits
`geometryQuality`	string`"standard"`	"standard" \| "detailed"
`topology`	string`"triangle"`	"triangle" \| "quad"
`textureQuality`	string`"standard"`	"off" \| "standard" \| "detailed"
`enablePbr`	boolean`false`	Requires textured output. Turning textures off disables PBR.
`faceCount`	integer`50000`	Minimum 1000. Maximum 2000000
`autoSize`	boolean`false`	No additional limit in this schema.

When textureQuality is "off", enablePbr must be false.

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`faceCount`	integer`50000`	Minimum 1000. Maximum 2000000
`geometryQuality`	string`"standard"`	"standard" \| "detailed"
`textureQuality`	string`"standard"`	"off" \| "standard" \| "detailed"
`topology`	string`"triangle"`	"triangle" \| "quad"
`pbr`	boolean`false`	Requires textured output. Turning textures off disables PBR.
`autoSize`	boolean`false`	No additional limit in this schema.
`orientation`	string`"default"`	"default" \| "align_image"
`textureAlignment`	string`"original_image"`	"original_image" \| "geometry"

When textureQuality is "off", pbr must be false.

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

Rodin 2.5 Fastrodin-2-5-fastText + image

Explore Rodin 2.5 Fast examples and browser workflows →

text-to-3d

Use inputs.prompt, up to 1000 characters.

Parameter	Type / default	Allowed values and limits
`meshQuality`	string`"auto"`	"auto" \| "4k-quad" \| "20k-triangle"
`material`	string`"PBR"`	"PBR" \| "Shaded"
`pose`	string`"original"`	"original" \| "rig-ready"
`textureDelight`	boolean`false`	No additional limit in this schema.

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`meshQuality`	string`"auto"`	"auto" \| "4k-quad" \| "20k-triangle"
`material`	string`"PBR"`	"PBR" \| "Shaded"
`pose`	string`"original"`	"original" \| "rig-ready"
`textureDelight`	boolean`false`	No additional limit in this schema.

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

Hunyuan3D 3.1 Rapidhunyuan-3-1-rapidText + image

Explore Hunyuan3D 3.1 Rapid examples and browser workflows →

text-to-3d

Use inputs.prompt, up to 1000 characters.

Parameter	Type / default	Allowed values and limits

No configurable parameters for this operation.

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`output`	string`"textured"`	"textured" \| "geometry"
`pbr`	boolean`false`	Requires textured output. Turning textures off disables PBR.

When output is "geometry", pbr must be false.

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

Hunyuan3D 3.0hunyuan-3Text + image

Explore Hunyuan3D 3.0 examples and browser workflows →

text-to-3d

Use inputs.prompt, up to 1000 characters.

Parameter	Type / default	Allowed values and limits
`generateType`	string`"Normal"`	"Normal" \| "Geometry" \| "LowPoly"
`enablePbr`	boolean`false`	Requires textured output. Turning textures off disables PBR.
`faceCount`	integer`500000`	Minimum 40000. Maximum 1500000
`topology`	string`"triangle"`	"triangle" \| "quad"

When generateType is "Geometry", enablePbr must be false.

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`generateType`	string`"Normal"`	"Normal" \| "Geometry" \| "LowPoly"
`pbr`	boolean`false`	Requires textured output. Turning textures off disables PBR.
`faceCount`	integer`500000`	Minimum 40000. Maximum 1500000
`polygonType`	string`"triangle"`	"triangle" \| "quad"

When generateType is "Geometry", pbr must be false.

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

Hunyuan3D 3.1 Prohunyuan-3-1-proText + image

Explore Hunyuan3D 3.1 Pro examples and browser workflows →

text-to-3d

Use inputs.prompt, up to 1000 characters.

Parameter	Type / default	Allowed values and limits
`generateType`	string`"Normal"`	"Normal" \| "Geometry"
`enablePbr`	boolean`false`	Requires textured output. Turning textures off disables PBR.
`faceCount`	integer`500000`	Minimum 40000. Maximum 1500000

When generateType is "Geometry", enablePbr must be false.

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`generateType`	string`"Normal"`	"Normal" \| "Geometry"
`pbr`	boolean`false`	Requires textured output. Turning textures off disables PBR.
`faceCount`	integer`500000`	Minimum 40000. Maximum 1500000

When generateType is "Geometry", pbr must be false.

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

Rodin 2.5rodin-2-5Text + image

Explore Rodin 2.5 examples and browser workflows →

text-to-3d

Use inputs.prompt, up to 1000 characters.

Parameter	Type / default	Allowed values and limits
`quality`	string`"standard"`	"standard" \| "extreme-high"
`highPack`	boolean`false`	No additional limit in this schema.
`material`	string`"PBR"`	"PBR" \| "Shaded"
`rodinTextureMode`	string`"regular"`	"regular" \| "delight"
`pose`	string`"original"`	"original" \| "rig-ready"

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`quality`	string`"standard"`	"standard" \| "extreme-high"
`highPack`	boolean`false`	No additional limit in this schema.
`material`	string`"PBR"`	"PBR" \| "Shaded"
`rodinTextureMode`	string`"regular"`	"regular" \| "delight"
`pose`	string`"original"`	"original" \| "rig-ready"

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

Tripo P2tripo-p2Text + image

Explore Tripo P2 examples and browser workflows →

text-to-3d

Use inputs.prompt, up to 1000 characters.

Parameter	Type / default	Allowed values and limits
`output`	string`"standard-texture"`	"geometry" \| "standard-texture" \| "detailed-texture" \| "extreme-texture"
`topology`	string`"triangle"`	"triangle" \| "quad"
`enablePbr`	boolean`true`	Requires textured output. Turning textures off disables PBR.
`faceCount`	integer`50000`	Minimum 48. Maximum 50000
`autoSize`	boolean`false`	No additional limit in this schema.
`delight`	boolean`true`	No additional limit in this schema.

When output is "geometry", enablePbr must be false.
When topology is "quad", faceCount must be at most 25000.

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`output`	string`"standard-texture"`	"geometry" \| "standard-texture" \| "detailed-texture" \| "extreme-texture"
`topology`	string`"triangle"`	"triangle" \| "quad"
`pbr`	boolean`true`	Requires textured output. Turning textures off disables PBR.
`faceLimit`	integer`50000`	Minimum 48. Maximum 50000
`delight`	boolean`true`	No additional limit in this schema.
`autoSize`	boolean`false`	No additional limit in this schema.

When output is "geometry", pbr must be false.
When topology is "quad", faceLimit must be at most 25000.

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

Meshy 7.1meshy-7-1Text + image

Explore Meshy 7.1 examples and browser workflows →

text-to-3d

Use inputs.prompt, up to 600 characters.

Parameter	Type / default	Allowed values and limits
`modelType`	string`"standard"`	"standard" \| "smart-topology"
`symmetryMode`	string`"auto"`	"off" \| "auto" \| "on"
`poseMode`	string`""`	"" \| "a-pose" \| "t-pose"
`shouldTexture`	boolean`true`	No additional limit in this schema.
`enablePbr`	boolean`false`	Requires textured output. Turning textures off disables PBR.
`topology`	string`"triangle"`	"triangle" \| "quad"
`geometryResolution`	string`"standard"`	"standard" \| "2k" \| "4k"
`faceCount`	integer`30000`	Minimum 100. Maximum 300000
`rigging`	boolean`false`	No additional limit in this schema.
`animation`	boolean`false`	Enable rigging before selecting animation.
`riggingHeightMeters`	number`1.7`	Minimum 0.5. Maximum 3
`animationActionId`	integer`92`	Minimum 0. Maximum 696

When shouldTexture is false, enablePbr must be false.
When rigging is false, animation must be false.
When modelType is "smart-topology", faceCount must be at most 15000.

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`modelType`	string`"standard"`	"standard" \| "smart-topology"
`symmetryMode`	string`"auto"`	"off" \| "auto" \| "on"
`poseMode`	string`""`	"" \| "a-pose" \| "t-pose"
`targetPolycount`	integer`30000`	Minimum 100. Maximum 300000
`topology`	string`"triangle"`	"triangle" \| "quad"
`texture`	boolean`true`	No additional limit in this schema.
`pbr`	boolean`false`	Requires textured output. Turning textures off disables PBR.
`geometryResolution`	string`"standard"`	"standard" \| "2k" \| "4k"
`rigging`	boolean`false`	No additional limit in this schema.
`animation`	boolean`false`	Enable rigging before selecting animation.
`riggingHeightMeters`	number`1.7`	Minimum 0.5. Maximum 3
`animationActionId`	integer`92`	Minimum 0. Maximum 696

When texture is false, pbr must be false.
When rigging is false, animation must be false.
When modelType is "smart-topology", targetPolycount must be at most 15000.

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

GPT-6 Astragpt-6-astraText + image

Explore GPT-6 Astra examples and browser workflows →

text-to-3d

Use inputs.prompt, up to 1000 characters.

Parameter	Type / default	Allowed values and limits
`size`	number`1`	Minimum 0.05. Maximum 20

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`prompt`	string`""`	Up to 1000 characters
`size`	number`1`	Minimum 0.05. Maximum 20

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

Hunyuan3D 2 Minihunyuan-2-miniImage

Explore Hunyuan3D 2 Mini examples and browser workflows →

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits

No configurable parameters for this operation.

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

TRELLIS.2trellis-2Image

Explore TRELLIS.2 examples and browser workflows →

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`resolution`	integer`1024`	512 \| 1024 \| 1536
`textureSize`	string`"standard"`	"standard" \| "4096"
`removeBackground`	boolean`true`	No additional limit in this schema.
`targetFaceCount`	integer`200000`	Minimum 10000. Maximum 500000
`seed`	integer`Not specified`	Minimum 0. Maximum 2147483647. Use a specific seed for this task.

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

Pixal3Dpixal3dImage

Explore Pixal3D examples and browser workflows →

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`resolution`	integer`1024`	1024 \| 1536
`textureSize`	integer`2048`	1024 \| 2048 \| 4096
`targetVertexCount`	integer`200000`	Minimum 5000. Maximum 1586021
`remesh`	boolean`true`	No additional limit in this schema.
`ssGuidanceStrength`	number`7.5`	Minimum 0. Maximum 10
`ssSamplingSteps`	integer`12`	Minimum 1. Maximum 50
`shapeGuidanceStrength`	number`7.5`	Minimum 0. Maximum 10
`shapeSamplingSteps`	integer`12`	Minimum 1. Maximum 50
`textureGuidanceStrength`	number`1`	Minimum 0. Maximum 10
`textureSamplingSteps`	integer`12`	Minimum 1. Maximum 50
`seed`	integer`Not specified`	Minimum 0. Maximum 2147483647. Use a specific seed for this task.

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

Seed3D 2.0seed3d-2Image

Explore Seed3D 2.0 examples and browser workflows →

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`subdivisionLevel`	integer`1`	0 \| 1 \| 2

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.

Hi3D 3.0hi3d-3Image

Explore Hi3D 3.0 examples and browser workflows →

image-to-3d

Use inputs.upload_ids with exactly one ID from a selected image upload. Remote image URLs are not accepted.

Parameter	Type / default	Allowed values and limits
`texture`	boolean`true`	No additional limit in this schema.
`pbr`	boolean`true`	Requires textured output. Turning textures off disables PBR.
`faceCount`	integer`2000000`	Minimum 100000. Maximum 2000000

When texture is false, pbr must be false.

Read job.assets for the actual returned formats, roles and download paths. Model selection does not guarantee every format or optional output.