Hunyuan3D v3 Image → 3D

{
  "model_id": "fal-ai/hunyuan3d-v3/image-to-3d",
  "prompt": "Reference: cute cartoon fox figurine",
  "input_image_url": "your_input_image_url",
  "reference_image_url": "https://example.com/reference_image"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhunyuan3d-v3%2Fimage-to-3d",
  "title": "Hunyuan3D v3 Image → 3D generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/hunyuan3d-v3/image-to-3d.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/hunyuan3d-v3/image-to-3d",
      "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"
    },
    "generate_type": {
      "title": "Generate Type",
      "description": "Generation type. Normal: textured model. LowPoly: polygon reduction. Geometry: white model without texture.",
      "default": "Normal",
      "type": "string",
      "enum": [
        "Normal",
        "LowPoly",
        "Geometry"
      ]
    },
    "enable_pbr": {
      "title": "Enable PBR",
      "description": "Whether to enable PBR material generation. Does not take effect when generate_type is Geometry.",
      "default": false,
      "type": "boolean"
    },
    "face_count": {
      "title": "Face Count",
      "description": "Target face count. Range: 40000–1500000.",
      "default": 500000,
      "type": "number",
      "minimum": 40000,
      "maximum": 1500000
    },
    "polygon_type": {
      "title": "Polygon Type",
      "description": "Polygon type. Only takes effect when Generate Type is LowPoly.",
      "default": "triangle",
      "type": "string",
      "enum": [
        "triangle",
        "quadrilateral"
      ]
    },
    "input_image_url": {
      "title": "Input Image URL",
      "description": "URL of image to use while generating the 3D model. Handled by the source image upload strip.",
      "type": "string"
    },
    "left_image_url": {
      "title": "Left View",
      "description": "Optional left view image for better 3D reconstruction.",
      "type": "string"
    },
    "right_image_url": {
      "title": "Right View",
      "description": "Optional right view image for better 3D reconstruction.",
      "type": "string"
    },
    "back_image_url": {
      "title": "Back View",
      "description": "Optional back view image for better 3D reconstruction.",
      "type": "string"
    },
    "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
}