## Basic model info - Model name: tencent-hunyuan/tencent-hunyuan hunyuan3d-v3.1 - Model description: Rapidly generate 3D models from images using Hunyuan 3D. - Endpoint name: image-to-3d ## Model schema The model schema is defined in the OpenAPI schema: [OpenAPI Schema](https://oapi.sunra.ai/main/tencent-hunyuan/hunyuan3d-v3.1/latest.json) ### Model input schema The model input schema is: ```json { "description": "Input schema for Hunyuan3D V3.1 Pro image-to-3D generation.", "properties": { "back_image": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "string" }, { "type": "null" } ], "description": "Optional back/rear view image URL.", "title": "Back Image", "x-sr-order": 501 }, "bottom_image": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "string" }, { "type": "null" } ], "description": "Optional bottom view image URL.", "title": "Bottom Image", "x-sr-order": 505 }, "enable_pbr": { "default": false, "description": "Enable PBR material generation (metallic, roughness, normal textures). Does not take effect when geometry_only is True.", "title": "Enable Pbr", "type": "boolean", "x-sr-order": 401 }, "face_count": { "anyOf": [ { "maximum": 1500000, "minimum": 40000, "type": "integer" }, { "type": "null" } ], "description": "Target polygon face count. Range: 40,000-1,500,000. Default: 500,000.", "title": "Face Count", "x-sr-order": 508 }, "geometry_only": { "default": false, "description": "Generate geometry-only white model without textures. When enabled, enable_pbr is ignored.", "title": "Geometry Only", "type": "boolean", "x-sr-order": 402 }, "image": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "string" } ], "description": "Front view image URL. Resolution: 128-5000px, max 8MB, formats: JPG/PNG/WEBP.", "title": "Image", "x-sr-order": 301 }, "left_front_image": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "string" }, { "type": "null" } ], "description": "Optional left-front 45 degree angle view image URL.", "title": "Left Front Image", "x-sr-order": 506 }, "left_image": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "string" }, { "type": "null" } ], "description": "Optional left side view image URL.", "title": "Left Image", "x-sr-order": 502 }, "right_front_image": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "string" }, { "type": "null" } ], "description": "Optional right-front 45 degree angle view image URL.", "title": "Right Front Image", "x-sr-order": 507 }, "right_image": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "string" }, { "type": "null" } ], "description": "Optional right side view image URL.", "title": "Right Image", "x-sr-order": 503 }, "top_image": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "string" }, { "type": "null" } ], "description": "Optional top view image URL.", "title": "Top Image", "x-sr-order": 504 } }, "required": [ "image" ], "title": "ImageTo3DInput", "type": "object" } ``` ### Model output schema The model output schema is: ```json { "description": "Unified output schema for Hunyuan3D V3.1.", "properties": { "model": { "description": "URL of the generated 3D model", "properties": { "content_type": { "description": "The mime type of the file.", "title": "Content Type", "type": "string" }, "file_name": { "description": "The name of the file. It will be auto-generated if not provided.", "title": "File Name", "type": "string" }, "file_size": { "description": "The size of the file in bytes.", "title": "File Size", "type": "integer" }, "url": { "description": "The URL where the file can be downloaded from.", "title": "Url", "type": "string" } }, "required": [ "content_type", "file_name", "file_size", "url" ], "title": "SunraFile", "type": "object" }, "score": { "description": "Billing score for image-to-3d: base + add-ons", "title": "Score", "type": "number" } }, "required": [ "model" ], "title": "Hunyuan3DV31Output", "type": "object" } ``` ## Example inputs and outputs Use the following example inputs and outputs to understand the model. ### Input example ```json { "back_image": null, "bottom_image": null, "enable_pbr": false, "face_count": null, "geometry_only": false, "image": "", "left_front_image": null, "left_image": null, "right_front_image": null, "right_image": null, "top_image": null } ``` ### Output example ```json { } ``` ## Model code examples ### JavaScript ```javascript import { sunra } from "@sunra/client"; const result = await sunra.subscribe("tencent-hunyuan/hunyuan3d-v3.1/image-to-3d", { input: { image: '', enable_pbr: false, geometry_only: false, back_image: null, left_image: null, right_image: null, top_image: null, bottom_image: null, left_front_image: null, right_front_image: null, face_count: null }, logs: true, onQueueUpdate: (update) => { console.log(`Status Update: ${update.status}, Request ID: ${update.request_id}`); }, }); console.log(result.data); console.log(result.requestId); ``` ### Python ```python import sunra_client result = sunra_client.subscribe( "tencent-hunyuan/hunyuan3d-v3.1/image-to-3d", arguments={ "image": "", "enable_pbr": False, "geometry_only": False, "back_image": None, "left_image": None, "right_image": None, "top_image": None, "bottom_image": None, "left_front_image": None, "right_front_image": None, "face_count": None }, with_logs=True, on_enqueue=print, on_queue_update=print, ) print(result) ``` ### Java ```java import ai.sunra.client.*; import java.util.Map; import com.google.gson.JsonObject; var client = SunraClient.withEnvCredentials(); var response = client.subscribe( "tencent-hunyuan/hunyuan3d-v3.1/image-to-3d", SubscribeOptions.builder() .input(Map.of( "image", "", "enable_pbr", false, "geometry_only", false, "back_image", null, "left_image", null, "right_image", null, "top_image", null, "bottom_image", null, "left_front_image", null, "right_front_image", null, "face_count", null)) .resultType(JsonObject.class) .onQueueUpdate(update -> System.out.printf( "\nStatus Update: %s, Request ID: %s%n", update.getStatus(), update.getRequestId() )) .logs(true) .build() ); System.out.println("Completed!"); System.out.println(response.getData()); ``` ### Kotlin ```kotlin import ai.sunra.client.kt.* import com.google.gson.JsonObject val client = createSunraClient() val response = client.subscribe( endpointId = "tencent-hunyuan/hunyuan3d-v3.1/image-to-3d", input = mapOf( "image" to "", "enable_pbr" to false, "geometry_only" to false, "back_image" to null, "left_image" to null, "right_image" to null, "top_image" to null, "bottom_image" to null, "left_front_image" to null, "right_front_image" to null, "face_count" to null), options = ai.sunra.client.kt.SubscribeOptions(logs = true), onUpdate = { update -> println("\nStatus Update: ${update.status}, Request ID: ${update.requestId}") } ) println("Completed!") println(response.data) ``` ### Curl ```bash curl --request POST \ --url https://api.sunra.ai/v1/queue/tencent-hunyuan/hunyuan3d-v3.1/image-to-3d \ --header "Authorization: Key $SUNRA_KEY" \ --header "Content-Type: application/json" \ --data '{"image":"","enable_pbr":false,"geometry_only":false,"back_image":null,"left_image":null,"right_image":null,"top_image":null,"bottom_image":null,"left_front_image":null,"right_front_image":null,"face_count":null}' ``` ## Model readme undefined