Tencent Hunyuan

Tencent Hunyuan remeshing API reference. AI-powered topology optimization with triangle or quad output and high, medium, low density presets.

Smart Topology

POST

/v1/3d-models/tencent/topology/

Restructure a 3D model's geometry using AI-powered smart topology. Supports GLB and OBJ input, triangle or quadrilateral output, and three density levels. Cost: 100 credits.

Request

curl -X POST https://api.3daistudio.com/v1/3d-models/tencent/topology/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_url": "https://example.com/model.glb",
    "file_type": "GLB",
    "polygon_type": "quadrilateral",
    "face_level": "medium"
  }'

Response

{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-02-25T12:00:00Z"
}

Parameters

Parameter	Type	Required	Description
file_url	string (URL)	Yes	URL to the source 3D model file.
file_type	string	No	Input file format: "GLB" or "OBJ". Default: "GLB".
polygon_type	string	No	Target mesh topology: "triangle" or "quadrilateral". Default: none (auto).
face_level	string	No	Target mesh density: "high", "medium", or "low". Default: none (auto).
output_format	string	No	Desired output format: "OBJ", "FBX", "STL", or "USDZ". Default: "OBJ".

Polygon Type

Controls the type of polygons in the output mesh.

Value	Description
triangle	Output mesh uses triangular faces. Best for real-time rendering, games, and AR/VR.
quadrilateral	Output mesh uses quad faces. Best for subdivision modeling, animation, and CAD workflows.

Face Level

Controls the density of the output mesh.

Value	Description
high	Preserves maximum geometric detail. Larger file size.
medium	Balanced detail and file size. Good for most use cases.
low	Aggressive simplification. Smallest file size, ideal for web and mobile.

Checking Status

GET

/v1/generation-request/<task_id>/status/

Poll this endpoint with the task_id from the submit response. When status is "FINISHED", the results array contains your remeshed 3D model with download URLs and thumbnails. Results expire after 24 hours.

Request

curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "status": "FINISHED",
  "progress": 100,
  "results": [
    {
      "asset_url": "https://cdn.3daistudio.com/models/remeshed_model.obj",
      "asset": "https://storage.3daistudio.com/assets/remeshed_model.obj",
      "asset_type": "3D_MODEL",
      "thumbnail": "https://storage.3daistudio.com/thumbnails/remeshed_model.png"
    }
  ]
}

Credit Costs

Operation	Credits
Smart Topology	100 credits

Processing Times

Smart topology typically takes 2–5 minutes depending on the complexity and polygon count of the input model.

Errors

Common errors for topology endpoints.

Status	Error Code	Description
402	insufficient_credits	Not enough credits. Top up your wallet.
429	rate_limited	Rate limit exceeded. Wait and retry.
400	validation_failed	Missing or invalid parameters.