---
title: "Hunyuan3D 3.1 Pro"
method: POST
path: "/generate/3d/tencent/hunyuan3d-3.1-pro"
tags: ["3D"]
---

# Hunyuan3D 3.1 Pro

`POST /generate/3d/tencent/hunyuan3d-3.1-pro`

High‑fidelity text or image‑to‑3D with optional PBR materials, multi‑view inputs, and adjustable face count for cleaner meshes.

## Headers

- `X-Webhook-URL` string, uri

## Request body

- object
  - `prompt` string
  - `seed` number
  - `input_mode` 'image' | 'text'
  - `generate_texture` boolean
  - `enable_pbr` boolean
  - `face_count` number
  - `back_image_url` string, uri — Optional back-view image URL.
  - `left_image_url` string, uri — Optional left-view image URL.
  - `right_image_url` string, uri — Optional right-view image URL.
  - `top_image_url` string, uri — Optional top-view image URL.
  - `bottom_image_url` string, uri — Optional bottom-view image URL.
  - `left_front_image_url` string, uri — Optional left-front-view image URL.
  - `right_front_image_url` string, uri — Optional right-front-view image URL.
  - `image_urls` string[] — Input image URLs for image-to-3D generation. Omit or pass an empty array for text-to-3D.

## Response `200`

The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.

- object
  - `job_id` string, uuid, required
  - `status` 'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled', required
  - `created_at` string, date-time, required
  - `completed_at` unknown, required
  - `result` unknown, required
  - `error` object
    - `code` string, required
    - `message` string

## Other responses

- `400` — The request body is invalid.
- `401` — You are not authenticated.
- `402` — You have run out of credits.
- `429` — You have reached the maximum number of concurrent jobs.

---

[API](https://skmtc.net/krea/apis/krea-api.md) · [All operations](https://skmtc.net/krea/apis/krea-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/krea/krea-api/revisions/404b319bb51e/schema)