Available now

Hunyuan 3D 3.1 Pro: text to 3D

By Tencent

Hunyuan 3D 3.1 Pro from Tencent builds a 3D model from one image or a text prompt and delivers it as a GLB file, textured or as plain geometry.

Model ID
Maker
Tencent

Model id

Use this in every request
hunyuan-3d/v3.1/pro/text-to-3d

This model has other modes with their own ids: hunyuan-3d/v3.1/pro/image-to-3d.

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hunyuan-3d/v3.1/pro/text-to-3d",
  "input": {
    "prompt": "A vintage brass diving helmet with three round glass portholes, riveted seams and a worn green patina."
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "hunyuan-3d/v3.1/pro/text-to-3d", "quote_id": "QUOTE_ID", "input": {"prompt":"A vintage brass diving helmet with three round glass portholes, riveted seams and a worn green patina."}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for hunyuan-3d/v3.1/pro/text-to-3d
NameTypeDescription
promptrequiredstring
Text description of the 3D content to generate. Max 1024 UTF-8 characters.
generate_typestring (enum)
Normal makes a textured model. Geometry makes an untextured white model.

Default: Normal

One of: Normal, Geometry

enable_pbrboolean
Generate PBR materials (metallic, roughness and normal textures). Available with the Normal generation type.

Default: false

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt
"outputs": [
  { "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]

Pricing

  • Textured or geometry only$0.60/ model
  • With PBR materials$0.84/ model

The exact charge for your input comes from a quote. How charges settle

API docs

About this model

Overview

Upload a front view of an object or describe it in a prompt. Normal makes a textured model; Geometry makes an untextured white model for when you only need the shape. With Normal you can also turn on PBR materials for metallic, roughness and normal textures.

What you can build

  • Textured props for scenes and renders
  • White models to sculpt or texture yourself
  • Product models from one front photo

Prompting tips

  • Use a front view with one object that fills more than half the frame, on a simple background.
  • Choose Geometry when you plan to texture the model yourself.
  • Turn on PBR materials when the model will be lit in a game engine or renderer.

Inputs

  • Prompt (required): Text description of the 3D content to generate. Max 1024 UTF-8 characters.
  • Generate Type (optional): Normal makes a textured model. Geometry makes an untextured white model. Options: Normal, Geometry.
  • Enable Pbr (optional): Generate PBR materials (metallic, roughness and normal textures). Available with the Normal generation type.

Output and limits

  • The download is one GLB file. Extra view images and a custom face count are not available here.
  • Small or dense text in the image can come out misspelled.
  • Hands, crowds and complex poses can show artifacts; generate a few variations and pick the best.
  • Some prompts or outputs can be refused by safety checks.

Price guide

  • Textured or geometry only: $0.60 / model
  • With PBR materials: $0.84 / model