
Output
3D mesh
Resolution
1024, 1536
Inputs
- Reference image (required)
Example prompt
A bronze art-nouveau lamp with vine-shaped stem and amber stained-glass shade, ornate cast-metal base, soft warm glowTry this prompt →
LLM-ready
API & LLM schema
Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/pixal3d.
POST
/api/v1/generate27 fields · 2 required| Field | Type | Requirement | Contract |
|---|---|---|---|
model_id | constant | Required | ArtEmotion model identifier. |
extra | object | Optional | Model-specific settings may also be nested here. |
max_credits | number | Optional | Reject before submission if the estimated list price exceeds this cap. · Range: 1–… |
webhook_url | string | Optional | Format: uri |
webhook_secret | string | Optional | Optional model input. |
folder_id | string | Optional | Optional model input. |
prompt | string | Optional | Optional model input. |
texture_size | number | Optional | Resolution of the texture image baked onto the mesh. Higher values capture finer surface details but produce larger files. · Allowed: 1024, 2048, 4096 · Default: 2048 |
ss_sampling_steps | number | Optional | Number of denoising steps for the initial structure. · Default: 12 · Range: 1–50 |
shape_slat_sampling_steps | number | Optional | Number of denoising steps for shape refinement. · Default: 12 · Range: 1–50 |
tex_slat_sampling_steps | number | Optional | Number of denoising steps for texture generation. · Default: 12 · Range: 1–50 |
ss_guidance_strength | number | Optional | How closely the initial 3D structure follows the input image. · Default: 7.5 · Range: 0–10 |
shape_slat_guidance_strength | number | Optional | How closely the detailed geometry follows the input image. · Default: 7.5 · Range: 0–10 |
tex_slat_guidance_strength | number | Optional | How closely the texture follows the input image colors. · Default: 1 · Range: 0–10 |
ss_rescale_t | number | Optional | Controls noise schedule sharpness for structure generation. · Default: 5 · Range: 1–6 |
shape_slat_rescale_t | number | Optional | Controls noise schedule sharpness for shape refinement. · Default: 3 · Range: 1–6 |
tex_slat_rescale_t | number | Optional | Controls noise schedule sharpness for texture generation. · Default: 3 · Range: 1–6 |
ss_guidance_rescale | number | Optional | Dampens artifacts from high guidance in stage 1. · Default: 0.7 · Range: 0–1 |
shape_slat_guidance_rescale | number | Optional | Dampens artifacts from high guidance in the shape stage. · Default: 0.5 · Range: 0–1 |
tex_slat_guidance_rescale | number | Optional | Dampens artifacts from high guidance in the texture stage. · Default: 0 · Range: 0–1 |
decimation_target | number | Optional | Target number of vertices in the final mesh. · Default: 200000 · Range: 5000–2000000 |
max_num_tokens | number | Optional | Maximum number of HR tokens used by the cascaded shape sampler. Higher values allow finer geometry. · Default: 49152 · Range: 4096–131072 |
mesh_scale | number | Optional | Scale factor applied to the inferred mesh. Affects camera distance estimation. · Default: 1 · Range: 0.1–4 |
remesh | boolean | Optional | Rebuild the mesh topology for cleaner triangles. · Default: true |
seed | integer | Optional | Random seed for reproducibility. |
resolution | string | Optional | Allowed: 1024, 1536 |
reference_image_url | string | Required | Format: uri |
Minimal request example
{
"model_id": "fal-ai/pixal3d",
"reference_image_url": "https://example.com/reference_image"
}Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpixal3d",
"title": "Pixal3D generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/pixal3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/pixal3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"texture_size": {
"title": "Texture Size",
"description": "Resolution of the texture image baked onto the mesh. Higher values capture finer surface details but produce larger files.",
"default": 2048,
"type": "number",
"enum": [
1024,
2048,
4096
]
},
"ss_sampling_steps": {
"title": "Structure Steps",
"description": "Number of denoising steps for the initial structure.",
"default": 12,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"shape_slat_sampling_steps": {
"title": "Shape Steps",
"description": "Number of denoising steps for shape refinement.",
"default": 12,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"tex_slat_sampling_steps": {
"title": "Texture Steps",
"description": "Number of denoising steps for texture generation.",
"default": 12,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"ss_guidance_strength": {
"title": "Structure Guidance",
"description": "How closely the initial 3D structure follows the input image.",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 10
},
"shape_slat_guidance_strength": {
"title": "Shape Guidance",
"description": "How closely the detailed geometry follows the input image.",
"default": 7.5,
"type": "number",
"minimum": 0,
"maximum": 10
},
"tex_slat_guidance_strength": {
"title": "Texture Guidance",
"description": "How closely the texture follows the input image colors.",
"default": 1,
"type": "number",
"minimum": 0,
"maximum": 10
},
"ss_rescale_t": {
"title": "Structure Rescale T",
"description": "Controls noise schedule sharpness for structure generation.",
"default": 5,
"type": "number",
"minimum": 1,
"maximum": 6
},
"shape_slat_rescale_t": {
"title": "Shape Rescale T",
"description": "Controls noise schedule sharpness for shape refinement.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 6
},
"tex_slat_rescale_t": {
"title": "Texture Rescale T",
"description": "Controls noise schedule sharpness for texture generation.",
"default": 3,
"type": "number",
"minimum": 1,
"maximum": 6
},
"ss_guidance_rescale": {
"title": "Structure Guidance Rescale",
"description": "Dampens artifacts from high guidance in stage 1.",
"default": 0.7,
"type": "number",
"minimum": 0,
"maximum": 1
},
"shape_slat_guidance_rescale": {
"title": "Shape Guidance Rescale",
"description": "Dampens artifacts from high guidance in the shape stage.",
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"tex_slat_guidance_rescale": {
"title": "Texture Guidance Rescale",
"description": "Dampens artifacts from high guidance in the texture stage.",
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1
},
"decimation_target": {
"title": "Decimation Target",
"description": "Target number of vertices in the final mesh.",
"default": 200000,
"type": "number",
"minimum": 5000,
"maximum": 2000000,
"multipleOf": 1
},
"max_num_tokens": {
"title": "Max Tokens",
"description": "Maximum number of HR tokens used by the cascaded shape sampler. Higher values allow finer geometry.",
"default": 49152,
"type": "number",
"minimum": 4096,
"maximum": 131072,
"multipleOf": 1
},
"mesh_scale": {
"title": "Mesh Scale",
"description": "Scale factor applied to the inferred mesh. Affects camera distance estimation.",
"default": 1,
"type": "number",
"minimum": 0.1,
"maximum": 4
},
"remesh": {
"title": "Remesh",
"description": "Rebuild the mesh topology for cleaner triangles.",
"default": true,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility.",
"type": "integer"
},
"resolution": {
"type": "string",
"enum": [
"1024",
"1536"
]
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"reference_image_url"
],
"additionalProperties": false
}FAQ
How much does Pixal3D cost on ArtEmotion?
Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.
Do I get my credits back if Pixal3D fails?
Yes — failed generations are never charged. The credits are released back to your balance automatically.
Can I call Pixal3D from the API?
Yes. Use POST /api/v1/generate with model_id: "fal-ai/pixal3d". See the API reference for the full schema.
Where are my generations stored?
Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.
Ready to generate with Pixal3D?
Start now →No commitment. New accounts get 50 free credits on signup. See pricing.