API docs / 3D models
pixal3d API
The OpenAPI schema for the fal-ai/pixal3d queue.
- Model id
fal-ai/pixal3d- Provider
- Tencent
- Output
- 3D
- Price
- From 105 credits per run, the same as on voor.ai. Options such as length or resolution can change it.
Request
POST https://voor.ai/v1/generations with "model": "fal-ai/pixal3d". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.
curl https://voor.ai/v1/generations \
-H "Authorization: Bearer $VOOR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "fal-ai/pixal3d",
"input": {
"reference_images": [
"https://example.com/input.png"
]
},
"callback_url": "https://example.com/webhooks/voor"
}'
# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
-H "Authorization: Bearer $VOOR_API_KEY"Input parameters
| Name | Type | Details |
|---|---|---|
reference_imagesrequired | array of URLs | URL of the input image to convert to 3D Up to 1 files · Accepts image/* |
resolution | number | Output resolution; higher is slower but more detailed Default: One of: 1024, 1536 |
seed | number | Random seed for reproducibility |
max_tokens | number | Maximum number of HR tokens used by the cascaded shape sampler. Higher values allow finer geometry; lower values reduce memory and time. Default: Min 4096 · Max 131072 |
texture_size | number | Resolution of the texture image baked onto the mesh. Higher values capture finer surface details but produce larger files. Default: One of: 1024, 2048, 4096 |
decimation_target | number | Target number of vertices in the final mesh. Lower values produce smaller files but less detail. Default: Min 5000 · Max 2000000 |
mesh_scale | number | Scale factor applied to the inferred mesh. Affects the camera distance estimation used by the model. Default: Min 0.1 · Max 4 |
remesh | boolean | Rebuild the mesh topology for cleaner triangles. Slower but usually produces better results for downstream use. Default: |
shape_slat_guidance_rescale | number | Dampens artifacts from high guidance in the shape stage. Increase if you see noisy geometry. Default: Min 0 · Max 1 |
shape_slat_guidance_strength | number | How closely the detailed geometry follows the input image. Higher values add more detail but may introduce noise. Default: Min 0 · Max 10 |
shape_slat_rescale_t | number | Controls noise schedule sharpness for shape refinement. Higher values produce sharper geometric details. Default: Min 1 · Max 6 |
shape_slat_steps | number | Number of denoising steps for shape refinement. More steps = slower but potentially smoother geometry. Default: Min 1 · Max 50 |
sparse_structure_guidance_rescale | number | Dampens artifacts from high guidance in stage 1. Lower values allow stronger guidance effects, higher values stabilize the output. Default: Min 0 · Max 1 |
sparse_structure_guidance_strength | number | How closely the initial 3D structure follows the input image. Higher values produce more faithful but potentially noisier results. Default: Min 0 · Max 10 |
sparse_structure_rescale_t | number | Controls noise schedule sharpness for structure generation. Higher values produce sharper transitions. Default: Min 1 · Max 6 |
sparse_structure_steps | number | Number of denoising steps for the initial structure. More steps = slower but potentially higher quality. Default: Min 1 · Max 50 |
tex_slat_guidance_rescale | number | Dampens artifacts from high guidance in the texture stage. Increase if textures look noisy or have color banding. Default: Min 0 · Max 1 |
tex_slat_guidance_strength | number | How closely the texture follows the input image colors. Higher values produce more vivid but potentially oversaturated textures. Default: Min 0 · Max 10 |
tex_slat_rescale_t | number | Controls noise schedule sharpness for texture generation. Higher values produce sharper texture details. Default: Min 1 · Max 6 |
tex_slat_steps | number | Number of denoising steps for texture generation. More steps = slower but potentially cleaner textures. Default: Min 1 · Max 50 |