Hunyuan3D v2 Mini

Credit-based pricing. Supports reference images.

Try Hunyuan3D v2 Mini →Compare models

Output

3D mesh

Aspect ratio

1:1

Resolution

1024

Inputs

Reference image (required)

Example prompt

A cute chibi robot companion with round glossy eyes, sky-blue panels, and blinking antenna ears

Try this prompt →

LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/hunyuan3d/v2/mini.

POST/api/v1/generate16 fields · 4 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	Required	Optional model input.
`guidance_scale`	number	Optional	Guidance scale for the model. · Default: 7.5 · Range: 0–20
`num_inference_steps`	number	Optional	Number of inference steps to perform. · Default: 50 · Range: 1–50
`textured_mesh`	boolean	Optional	Generate a fully textured mesh (3× the white-mesh price). Turn off for a cheaper untextured geometry-only model. · Default: true
`octree_resolution`	number	Optional	Octree resolution for the model. · Default: 256 · Range: 1–1024
`input_image_url`	string	Required	Handled by the source image upload strip via buildFalInput.
`seed`	integer	Optional	The same seed and the same prompt given to the same version of the model will output the same image every time.
`aspect_ratio`	string	Optional	Allowed: 1:1
`resolution`	string	Optional	Allowed: 1024
`reference_image_url`	string	Required	Format: uri

Minimal request example

{
  "model_id": "fal-ai/hunyuan3d/v2/mini",
  "prompt": "A cute chibi robot companion with round glossy eyes, sky-blue panels, and blinking antenna ears",
  "input_image_url": "your_input_image_url",
  "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%2Fhunyuan3d%2Fv2%2Fmini",
  "title": "Hunyuan3D v2 Mini generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/hunyuan3d/v2/mini.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/hunyuan3d/v2/mini",
      "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"
    },
    "guidance_scale": {
      "title": "Guidance Scale",
      "description": "Guidance scale for the model.",
      "default": 7.5,
      "type": "number",
      "minimum": 0,
      "maximum": 20
    },
    "num_inference_steps": {
      "title": "Inference Steps",
      "description": "Number of inference steps to perform.",
      "default": 50,
      "type": "number",
      "minimum": 1,
      "maximum": 50
    },
    "textured_mesh": {
      "title": "Textured Mesh",
      "description": "Generate a fully textured mesh (3× the white-mesh price). Turn off for a cheaper untextured geometry-only model.",
      "default": true,
      "type": "boolean"
    },
    "octree_resolution": {
      "title": "Octree Resolution",
      "description": "Octree resolution for the model.",
      "default": 256,
      "type": "number",
      "minimum": 1,
      "maximum": 1024
    },
    "input_image_url": {
      "title": "Input Image URL",
      "description": "Handled by the source image upload strip via buildFalInput.",
      "type": "string"
    },
    "seed": {
      "title": "Seed",
      "description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
      "type": "integer"
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1024"
      ]
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "input_image_url",
    "reference_image_url"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

How much does Hunyuan3D v2 Mini 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 Hunyuan3D v2 Mini fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Hunyuan3D v2 Mini from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/hunyuan3d/v2/mini". 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 Hunyuan3D v2 Mini?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.