Tencent Hunyuan Image · 3D · Image

PanoramaNEW

📌 What is this：Hunyuan World panorama: generate a 7680x3840 360° panorama from text.

💡 When to use：Use for VR / panoramic showcases and scene concepts. Default output only; resolution / aspectRatio / reference images are not accepted.

Endpoints

Usage	Method	Path
Submit task	POST	/api/cqt/generator/hunyuan
Query Result	GET	/api/cqt/info/hunyuan?id={taskId}

⏱ Recommended polling interval：Poll every 5-10s until status = succeeded / failed.

Request Parameters

Param	Type	Required	Description
model	string	Required	Fixed hunyuan-world-panorama-2.1
prompt	string	Required	Scene description
negativePrompt / seed / enhancePrompt	string / integer / boolean	—	Negative prompt / random seed / auto-enhance prompt (optional)

Request Example

curl -X POST https://api.cqtai.com/api/cqt/generator/hunyuan \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "hunyuan-world-panorama-2.1",
    "prompt": "a misty mountain valley at sunrise, panoramic view"
  }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "58101e8368fa45c18e3cf267f6355946",
    "resultUrl": "https://cdn.novapi.ai/hunyuan/1791950087683_d50e662241544c9a9cc4bf7572f65987.png",
    "status": "succeeded",
    "errorMsg": null,
    "createTime": "2026-10-14 11:53:26",
    "completeTime": "2026-10-14 11:54:49"
  }
}

Response Fields

Field	Type	Description
code	number	200 means success
data.id	string	Task ID (taskId)
data.status	string	queued / running / succeeded / failed
data.resultUrl	string	Result URL(s) on our CDN (long-lived); multiple results are comma-separated; null until done or on failure
data.errorMsg	string \| null	Failure reason; null on success