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

NameTypeDetails
reference_imagesrequiredarray of URLs

URL of the input image to convert to 3D

Up to 1 files · Accepts image/*

resolutionnumber

Output resolution; higher is slower but more detailed

Default: 1024

One of: 1024, 1536

seednumber

Random seed for reproducibility

max_tokensnumber

Maximum number of HR tokens used by the cascaded shape sampler. Higher values allow finer geometry; lower values reduce memory and time.

Default: 49152

Min 4096 · Max 131072

texture_sizenumber

Resolution of the texture image baked onto the mesh. Higher values capture finer surface details but produce larger files.

Default: 2048

One of: 1024, 2048, 4096

decimation_targetnumber

Target number of vertices in the final mesh. Lower values produce smaller files but less detail.

Default: 200000

Min 5000 · Max 2000000

mesh_scalenumber

Scale factor applied to the inferred mesh. Affects the camera distance estimation used by the model.

Default: 1

Min 0.1 · Max 4

remeshboolean

Rebuild the mesh topology for cleaner triangles. Slower but usually produces better results for downstream use.

Default: true

shape_slat_guidance_rescalenumber

Dampens artifacts from high guidance in the shape stage. Increase if you see noisy geometry.

Default: 0.5

Min 0 · Max 1

shape_slat_guidance_strengthnumber

How closely the detailed geometry follows the input image. Higher values add more detail but may introduce noise.

Default: 7.5

Min 0 · Max 10

shape_slat_rescale_tnumber

Controls noise schedule sharpness for shape refinement. Higher values produce sharper geometric details.

Default: 3

Min 1 · Max 6

shape_slat_stepsnumber

Number of denoising steps for shape refinement. More steps = slower but potentially smoother geometry.

Default: 12

Min 1 · Max 50

sparse_structure_guidance_rescalenumber

Dampens artifacts from high guidance in stage 1. Lower values allow stronger guidance effects, higher values stabilize the output.

Default: 0.7

Min 0 · Max 1

sparse_structure_guidance_strengthnumber

How closely the initial 3D structure follows the input image. Higher values produce more faithful but potentially noisier results.

Default: 7.5

Min 0 · Max 10

sparse_structure_rescale_tnumber

Controls noise schedule sharpness for structure generation. Higher values produce sharper transitions.

Default: 5

Min 1 · Max 6

sparse_structure_stepsnumber

Number of denoising steps for the initial structure. More steps = slower but potentially higher quality.

Default: 12

Min 1 · Max 50

tex_slat_guidance_rescalenumber

Dampens artifacts from high guidance in the texture stage. Increase if textures look noisy or have color banding.

Default: 0

Min 0 · Max 1

tex_slat_guidance_strengthnumber

How closely the texture follows the input image colors. Higher values produce more vivid but potentially oversaturated textures.

Default: 1

Min 0 · Max 10

tex_slat_rescale_tnumber

Controls noise schedule sharpness for texture generation. Higher values produce sharper texture details.

Default: 3

Min 1 · Max 6

tex_slat_stepsnumber

Number of denoising steps for texture generation. More steps = slower but potentially cleaner textures.

Default: 12

Min 1 · Max 50