# Hunyuan 3D Rapid Image to 3D > Rapidly generate 3D models from images using Hunyuan 3D. ## Overview - **Endpoint**: `https://fal.run/fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d` - **Model ID**: `fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d` - **Category**: image-to-3d - **Kind**: inference **Tags**: 3d, hunyuan, image-to-3d ## Pricing Your request will cost $0.225 per generation. For $1.00, you can run this model 4 times. Base generation (text or image to 3D) costs $0.225. Enabling PBR materials adds $0.15. For more details, see [fal.ai pricing](https://fal.ai/pricing). ## API Information This model can be used via our HTTP API or more conveniently via our client libraries. See the input and output schema below, as well as the usage examples. ### Input Schema The API accepts the following input parameters: - **`input_image_url`** (`string`, _required_): Front view image URL. Resolution: 128-5000px, max 8MB (recommended ≤6MB for base64 encoding), formats: JPG/PNG/WEBP. Tips: simple background, single object, object >50% of frame. - Examples: "https://v3b.fal.media/files/b/0a865ab1/omYcawLUo4RZbO8J6ZgZR.png" - **`enable_pbr`** (`boolean`, _optional_): Enable PBR material generation (metallic, roughness, normal textures). Does not take effect when enable_geometry is True. - Default: `false` - **`enable_geometry`** (`boolean`, _optional_): Generate geometry-only white model without textures. When enabled, enable_pbr is ignored and OBJ is not supported (default output is GLB). - Default: `false` **Required Parameters Example**: ```json { "input_image_url": "https://v3b.fal.media/files/b/0a865ab1/omYcawLUo4RZbO8J6ZgZR.png" } ``` ### Output Schema The API returns the following output format: - **`model_glb`** (`File`, _optional_): Generated 3D model file. Contains GLB if available, otherwise OBJ. - Examples: {"url":"https://v3b.fal.media/files/b/0a8c4439/vj933H8B4W3wbd3e2RNby_8b1dbea208d194b9089a950abc2df426.obj","file_name":"8b1dbea208d194b9089a950abc2df426.obj","file_size":3172659,"content_type":"model/obj"} - **`material_mtl`** (`File`, _optional_): MTL material file for the OBJ model. - Examples: {"url":"https://v3b.fal.media/files/b/0a8c4439/_RhytNH4xZ5EFHr34YzJt_material.mtl","file_name":"material.mtl","file_size":88,"content_type":"text/plain"} - **`texture`** (`File`, _optional_): Texture image for the 3D model. - Examples: {"url":"https://v3b.fal.media/files/b/0a8c4439/_4NXiSoGcZ-GYwmgUTfHZ_texture_20250901.png","file_name":"texture_20250901.png","file_size":11728567,"content_type":"image/png"} - **`thumbnail`** (`File`, _optional_): Preview thumbnail of the generated model - Examples: {"url":"https://v3b.fal.media/files/b/0a8c4439/70Sm1pZ16SQP-mEbaKICC_preview.png","file_name":"preview.png","file_size":82521,"content_type":"image/png"} - **`model_urls`** (`ModelUrls`, _required_): URLs for different 3D model formats. - Examples: {"obj":{"url":"https://v3b.fal.media/files/b/0a8c4439/vj933H8B4W3wbd3e2RNby_8b1dbea208d194b9089a950abc2df426.obj","file_name":"8b1dbea208d194b9089a950abc2df426.obj","file_size":3172659,"content_type":"model/obj"},"texture":{"url":"https://v3b.fal.media/files/b/0a8c4439/_4NXiSoGcZ-GYwmgUTfHZ_texture_20250901.png","file_name":"texture_20250901.png","file_size":11728567,"content_type":"image/png"},"mtl":{"url":"https://v3b.fal.media/files/b/0a8c4439/_RhytNH4xZ5EFHr34YzJt_material.mtl","file_name":"material.mtl","file_size":88,"content_type":"text/plain"}} **Example Response**: ```json { "model_glb": { "url": "https://v3b.fal.media/files/b/0a8c4439/vj933H8B4W3wbd3e2RNby_8b1dbea208d194b9089a950abc2df426.obj", "file_name": "8b1dbea208d194b9089a950abc2df426.obj", "file_size": 3172659, "content_type": "model/obj" }, "material_mtl": { "url": "https://v3b.fal.media/files/b/0a8c4439/_RhytNH4xZ5EFHr34YzJt_material.mtl", "file_name": "material.mtl", "file_size": 88, "content_type": "text/plain" }, "texture": { "url": "https://v3b.fal.media/files/b/0a8c4439/_4NXiSoGcZ-GYwmgUTfHZ_texture_20250901.png", "file_name": "texture_20250901.png", "file_size": 11728567, "content_type": "image/png" }, "thumbnail": { "url": "https://v3b.fal.media/files/b/0a8c4439/70Sm1pZ16SQP-mEbaKICC_preview.png", "file_name": "preview.png", "file_size": 82521, "content_type": "image/png" }, "model_urls": { "obj": { "url": "https://v3b.fal.media/files/b/0a8c4439/vj933H8B4W3wbd3e2RNby_8b1dbea208d194b9089a950abc2df426.obj", "file_name": "8b1dbea208d194b9089a950abc2df426.obj", "file_size": 3172659, "content_type": "model/obj" }, "texture": { "url": "https://v3b.fal.media/files/b/0a8c4439/_4NXiSoGcZ-GYwmgUTfHZ_texture_20250901.png", "file_name": "texture_20250901.png", "file_size": 11728567, "content_type": "image/png" }, "mtl": { "url": "https://v3b.fal.media/files/b/0a8c4439/_RhytNH4xZ5EFHr34YzJt_material.mtl", "file_name": "material.mtl", "file_size": 88, "content_type": "text/plain" } } } ``` ## Usage Examples ### cURL ```bash curl --request POST \ --url https://fal.run/fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "input_image_url": "https://v3b.fal.media/files/b/0a865ab1/omYcawLUo4RZbO8J6ZgZR.png" }' ``` ### Python Ensure you have the Python client installed: ```bash pip install fal-client ``` Then use the API client to make requests: ```python import fal_client def on_queue_update(update): if isinstance(update, fal_client.InProgress): for log in update.logs: print(log["message"]) result = fal_client.subscribe( "fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d", arguments={ "input_image_url": "https://v3b.fal.media/files/b/0a865ab1/omYcawLUo4RZbO8J6ZgZR.png" }, with_logs=True, on_queue_update=on_queue_update, ) print(result) ``` ### JavaScript Ensure you have the JavaScript client installed: ```bash npm install --save @fal-ai/client ``` Then use the API client to make requests: ```javascript import { fal } from "@fal-ai/client"; const result = await fal.subscribe("fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d", { input: { input_image_url: "https://v3b.fal.media/files/b/0a865ab1/omYcawLUo4RZbO8J6ZgZR.png" }, logs: true, onQueueUpdate: (update) => { if (update.status === "IN_PROGRESS") { update.logs.map((log) => log.message).forEach(console.log); } }, }); console.log(result.data); console.log(result.requestId); ``` ## Additional Resources ### Documentation - [Model Playground](https://fal.ai/models/fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d) - [API Documentation](https://fal.ai/models/fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d/api) - [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/hunyuan-3d/v3.1/rapid/image-to-3d) ### fal.ai Platform - [Platform Documentation](https://docs.fal.ai) - [Python Client](https://docs.fal.ai/clients/python) - [JavaScript Client](https://docs.fal.ai/clients/javascript)