腾讯混元图像服务状态 - TimRouter API 中转端点

端点详细说明

腾讯混元图像服务状态端点供应腾讯混元（Hunyuan）图像相关服务的实时可用性查询。在发起图像产出发起请求之前，先确认服务状态可以避免不必要的未顺利完成等待时间，提升开发体验。

TimRouter 会在管理控制台和 API 层面展示各服务的健康状态，建议在业务代码中加入服务状态预检逻辑，提高发起请求顺利完成率。

认证

Python 发起调用用例

import requests

url = "https://api.timrouter.com/v1/images/status"
headers = {"Authorization": "Bearer sk-xxxxxxxxxxxx"}

response = requests.get(url, headers=headers)
result = response.json()

status = result.get("status", "unknown")
service = result.get("service", "hunyuan-image")

print(f"服务商: {service}")
print(f"服务状态: {status}")

if status == "healthy":
    print("服务正常，可以发起图像生成请求")
elif status == "degraded":
    print("服务降级中，部分功能可能不稳定")
else:
    print("服务不可用，请稍后重试")
    print(f"详情: {result.get('message', '')}")

响应字段

使用建议

• 在发起调用图像产出前先查询状态，避免无效等待
• 批量任务前检查状态，状态不佳时分散到不同时间提交
• 关注管理控制台公告，提前了解计划维护时间窗口
• 实现指数退避重试，服务恢复后自动恢复发起请求

发起调用代码用例

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ]
}