# Quady3D model API reference 14 model IDs, 23 model/input combinations. This is a static contract reference. Read authenticated GET /api/v1/models for current availability and parameter_schema; obtain POST /api/v1/quotes for the exact request cost. A reference entry is not proof of current availability or a completed supplier test. ## Connect and deliver 1. Sign in to your Quady3D account. Buy a credit pack or subscription at /pricing if you need credits and download access. A checkout return alone is not payment confirmation. 2. Create a dedicated Key in /account?section=connections with the scopes needed by your client. Key limits do not add balance or download rights. 3. Check GET /api/v1/account and GET /api/v1/models?operation=text-to-3d (or image-to-3d). Only use an available entry and its returned schema. 4. Text uses inputs.prompt. Image uses one raw PNG/JPEG/WebP upload (maximum 8 MiB) to POST /api/v1/uploads, then inputs.upload_ids containing exactly that one ID. Remote image URLs and multi-image input are not accepted by this API. 5. Quote the exact model, operation, input and parameters. Save the exact quoted body with quote_id and max_credits, plus an Idempotency-Key, before POST /api/v1/jobs. 6. Keep the original task. Recover with GET /api/v1/jobs/{id}, or replay the exact body and original Idempotency-Key after a lost submit response. Keep recovery state tied to the original account and API address. 7. On success, use the actual job.assets and their download_path. Downloading requires ownership, assets:read and account download access. Do not assume an output format, regenerate on a download error or overwrite existing files. Complete safe examples: /developers/docs/clients.md. Endpoint fields and errors: /developers/docs/api.md. Human reference: /developers/models. ## API scope The public generation operations are text-to-3d and image-to-3d. Sketch, multi-view, standalone PBR generation, remeshing, conversion, standalone rigging/animation and native Blender scene control are not public API operations. A model's texture, PBR or rigging setting applies only within its supported generation request. Website creators and upstream supplier APIs can offer different features or parameter names. ## Tripo H3.1 — tripo-h3-1 Model guide: /models/tripo-h3-1 ### text-to-3d Input: prompt, maximum 1000 characters. Default estimate: 20 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "text-to-3d", "model": "tripo-h3-1", "inputs": { "prompt": "A stylized wooden chest" }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - geometryQuality (string); default "standard". "standard" | "detailed" - topology (string); default "triangle". "triangle" | "quad" - textureQuality (string); default "standard". "off" | "standard" | "detailed" - enablePbr (boolean); default false. Requires textured output. Turning textures off disables PBR. - faceCount (integer); default 50000. Minimum 1000. Maximum 2000000 - autoSize (boolean); default false. No additional limit in this schema. - Constraint: When textureQuality is "off", enablePbr must be false. ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 30 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "tripo-h3-1", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - faceCount (integer); default 50000. Minimum 1000. Maximum 2000000 - geometryQuality (string); default "standard". "standard" | "detailed" - textureQuality (string); default "standard". "off" | "standard" | "detailed" - topology (string); default "triangle". "triangle" | "quad" - pbr (boolean); default false. Requires textured output. Turning textures off disables PBR. - autoSize (boolean); default false. No additional limit in this schema. - orientation (string); default "default". "default" | "align_image" - textureAlignment (string); default "original_image". "original_image" | "geometry" - Constraint: When textureQuality is "off", pbr must be false. ## Rodin 2.5 Fast — rodin-2-5-fast Model guide: /models#model-rodin-2-5-fast ### text-to-3d Input: prompt, maximum 1000 characters. Default estimate: 10 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "text-to-3d", "model": "rodin-2-5-fast", "inputs": { "prompt": "A stylized wooden chest" }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - meshQuality (string); default "auto". "auto" | "4k-quad" | "20k-triangle" - material (string); default "PBR". "PBR" | "Shaded" - pose (string); default "original". "original" | "rig-ready" - textureDelight (boolean); default false. No additional limit in this schema. ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 10 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "rodin-2-5-fast", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - meshQuality (string); default "auto". "auto" | "4k-quad" | "20k-triangle" - material (string); default "PBR". "PBR" | "Shaded" - pose (string); default "original". "original" | "rig-ready" - textureDelight (boolean); default false. No additional limit in this schema. ## Hunyuan3D 3.1 Rapid — hunyuan-3-1-rapid Model guide: /models/hunyuan3d-v3-1-rapid ### text-to-3d Input: prompt, maximum 1000 characters. Default estimate: 23 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "text-to-3d", "model": "hunyuan-3-1-rapid", "inputs": { "prompt": "A stylized wooden chest" }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - No configurable parameters for this operation. ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 23 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "hunyuan-3-1-rapid", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - output (string); default "textured". "textured" | "geometry" - pbr (boolean); default false. Requires textured output. Turning textures off disables PBR. - Constraint: When output is "geometry", pbr must be false. ## Hunyuan3D 3.0 — hunyuan-3 Model guide: /models/hunyuan3d-v3 ### text-to-3d Input: prompt, maximum 1000 characters. Default estimate: 63 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "text-to-3d", "model": "hunyuan-3", "inputs": { "prompt": "A stylized wooden chest" }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - generateType (string); default "Normal". "Normal" | "Geometry" | "LowPoly" - enablePbr (boolean); default false. Requires textured output. Turning textures off disables PBR. - faceCount (integer); default 500000. Minimum 40000. Maximum 1500000 - topology (string); default "triangle". "triangle" | "quad" - Constraint: When generateType is "Geometry", enablePbr must be false. ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 63 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "hunyuan-3", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - generateType (string); default "Normal". "Normal" | "Geometry" | "LowPoly" - pbr (boolean); default false. Requires textured output. Turning textures off disables PBR. - faceCount (integer); default 500000. Minimum 40000. Maximum 1500000 - polygonType (string); default "triangle". "triangle" | "quad" - Constraint: When generateType is "Geometry", pbr must be false. ## Hunyuan3D 3.1 Pro — hunyuan-3-1-pro Model guide: /models#model-hunyuan-3-1-pro ### text-to-3d Input: prompt, maximum 1000 characters. Default estimate: 38 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "text-to-3d", "model": "hunyuan-3-1-pro", "inputs": { "prompt": "A stylized wooden chest" }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - generateType (string); default "Normal". "Normal" | "Geometry" - enablePbr (boolean); default false. Requires textured output. Turning textures off disables PBR. - faceCount (integer); default 500000. Minimum 40000. Maximum 1500000 - Constraint: When generateType is "Geometry", enablePbr must be false. ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 38 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "hunyuan-3-1-pro", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - generateType (string); default "Normal". "Normal" | "Geometry" - pbr (boolean); default false. Requires textured output. Turning textures off disables PBR. - faceCount (integer); default 500000. Minimum 40000. Maximum 1500000 - Constraint: When generateType is "Geometry", pbr must be false. ## Rodin 2.5 — rodin-2-5 Model guide: /models/rodin-2-5 ### text-to-3d Input: prompt, maximum 1000 characters. Default estimate: 40 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "text-to-3d", "model": "rodin-2-5", "inputs": { "prompt": "A stylized wooden chest" }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - quality (string); default "standard". "standard" | "extreme-high" - highPack (boolean); default false. No additional limit in this schema. - material (string); default "PBR". "PBR" | "Shaded" - rodinTextureMode (string); default "regular". "regular" | "delight" - pose (string); default "original". "original" | "rig-ready" ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 40 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "rodin-2-5", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - quality (string); default "standard". "standard" | "extreme-high" - highPack (boolean); default false. No additional limit in this schema. - material (string); default "PBR". "PBR" | "Shaded" - rodinTextureMode (string); default "regular". "regular" | "delight" - pose (string); default "original". "original" | "rig-ready" ## Tripo P2 — tripo-p2 Model guide: /models/tripo-p2 ### text-to-3d Input: prompt, maximum 1000 characters. Default estimate: 110 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "text-to-3d", "model": "tripo-p2", "inputs": { "prompt": "A stylized wooden chest" }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - output (string); default "standard-texture". "geometry" | "standard-texture" | "detailed-texture" | "extreme-texture" - topology (string); default "triangle". "triangle" | "quad" - enablePbr (boolean); default true. Requires textured output. Turning textures off disables PBR. - faceCount (integer); default 50000. Minimum 48. Maximum 50000 - autoSize (boolean); default false. No additional limit in this schema. - delight (boolean); default true. No additional limit in this schema. - Constraint: When output is "geometry", enablePbr must be false. - Constraint: When topology is "quad", faceCount must be at most 25000. ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 110 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "tripo-p2", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - output (string); default "standard-texture". "geometry" | "standard-texture" | "detailed-texture" | "extreme-texture" - topology (string); default "triangle". "triangle" | "quad" - pbr (boolean); default true. Requires textured output. Turning textures off disables PBR. - faceLimit (integer); default 50000. Minimum 48. Maximum 50000 - delight (boolean); default true. No additional limit in this schema. - autoSize (boolean); default false. No additional limit in this schema. - Constraint: When output is "geometry", pbr must be false. - Constraint: When topology is "quad", faceLimit must be at most 25000. ## Meshy 7.1 — meshy-7-1 Model guide: /models/meshy-v7 ### text-to-3d Input: prompt, maximum 600 characters. Default estimate: 144 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "text-to-3d", "model": "meshy-7-1", "inputs": { "prompt": "A stylized wooden chest" }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - modelType (string); default "standard". "standard" | "smart-topology" - symmetryMode (string); default "auto". "off" | "auto" | "on" - poseMode (string); default "". "" | "a-pose" | "t-pose" - shouldTexture (boolean); default true. No additional limit in this schema. - enablePbr (boolean); default false. Requires textured output. Turning textures off disables PBR. - topology (string); default "triangle". "triangle" | "quad" - geometryResolution (string); default "standard". "standard" | "2k" | "4k" - faceCount (integer); default 30000. Minimum 100. Maximum 300000 - rigging (boolean); default false. No additional limit in this schema. - animation (boolean); default false. Enable rigging before selecting animation. - riggingHeightMeters (number); default 1.7. Minimum 0.5. Maximum 3 - animationActionId (integer); default 92. Minimum 0. Maximum 696 - Constraint: When shouldTexture is false, enablePbr must be false. - Constraint: When rigging is false, animation must be false. - Constraint: When modelType is "smart-topology", faceCount must be at most 15000. ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 120 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "meshy-7-1", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - modelType (string); default "standard". "standard" | "smart-topology" - symmetryMode (string); default "auto". "off" | "auto" | "on" - poseMode (string); default "". "" | "a-pose" | "t-pose" - targetPolycount (integer); default 30000. Minimum 100. Maximum 300000 - topology (string); default "triangle". "triangle" | "quad" - texture (boolean); default true. No additional limit in this schema. - pbr (boolean); default false. Requires textured output. Turning textures off disables PBR. - geometryResolution (string); default "standard". "standard" | "2k" | "4k" - rigging (boolean); default false. No additional limit in this schema. - animation (boolean); default false. Enable rigging before selecting animation. - riggingHeightMeters (number); default 1.7. Minimum 0.5. Maximum 3 - animationActionId (integer); default 92. Minimum 0. Maximum 696 - Constraint: When texture is false, pbr must be false. - Constraint: When rigging is false, animation must be false. - Constraint: When modelType is "smart-topology", targetPolycount must be at most 15000. ## GPT-6 Astra — gpt-6-astra Model guide: /models/gpt-6-astra ### text-to-3d Input: prompt, maximum 1000 characters. Default estimate: 800 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "text-to-3d", "model": "gpt-6-astra", "inputs": { "prompt": "A stylized wooden chest" }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - size (number); default 1. Minimum 0.05. Maximum 20 ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 800 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "gpt-6-astra", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - prompt (string); default "". Up to 1000 characters - size (number); default 1. Minimum 0.05. Maximum 20 ## Hunyuan3D 2 Mini — hunyuan-2-mini Model guide: /models#model-hunyuan-2-mini ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 12 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "hunyuan-2-mini", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - No configurable parameters for this operation. ## TRELLIS.2 — trellis-2 Model guide: /models/trellis-2 ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 20 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "trellis-2", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - resolution (integer); default 1024. 512 | 1024 | 1536 - textureSize (string); default "standard". "standard" | "4096" - removeBackground (boolean); default true. No additional limit in this schema. - targetFaceCount (integer); default 200000. Minimum 10000. Maximum 500000 - seed (integer); default not specified. Minimum 0. Maximum 2147483647. Use a specific seed for this task. ## Pixal3D — pixal3d Model guide: /models/pixal3d ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 30 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "pixal3d", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - resolution (integer); default 1024. 1024 | 1536 - textureSize (integer); default 2048. 1024 | 2048 | 4096 - targetVertexCount (integer); default 200000. Minimum 5000. Maximum 1586021 - remesh (boolean); default true. No additional limit in this schema. - ssGuidanceStrength (number); default 7.5. Minimum 0. Maximum 10 - ssSamplingSteps (integer); default 12. Minimum 1. Maximum 50 - shapeGuidanceStrength (number); default 7.5. Minimum 0. Maximum 10 - shapeSamplingSteps (integer); default 12. Minimum 1. Maximum 50 - textureGuidanceStrength (number); default 1. Minimum 0. Maximum 10 - textureSamplingSteps (integer); default 12. Minimum 1. Maximum 50 - seed (integer); default not specified. Minimum 0. Maximum 2147483647. Use a specific seed for this task. ## Seed3D 2.0 — seed3d-2 Model guide: /models/seed3d-2 ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 35 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "seed3d-2", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - subdivisionLevel (integer); default 1. 0 | 1 | 2 ## Hi3D 3.0 — hi3d-3 Model guide: /models/hi3d-v3 ### image-to-3d Input: one upload ID in inputs.upload_ids; PNG/JPEG/WebP, maximum 8388608 bytes. Default estimate: 210 credits. Parameters can change the cost; the quote is authoritative. Quote request JSON (replace the image placeholder with the owned upload ID when applicable; quoting does not submit a generation): ```json { "operation": "image-to-3d", "model": "hi3d-3", "inputs": { "upload_ids": [ "" ] }, "parameters": {} } ``` Parameters (all optional; omitted values use the schema defaults): - texture (boolean); default true. No additional limit in this schema. - pbr (boolean); default true. Requires textured output. Turning textures off disables PBR. - faceCount (integer); default 2000000. Minimum 100000. Maximum 2000000 - Constraint: When texture is false, pbr must be false.