腾讯混元图像服务状态 - QuickRouter API 中转接口

接口说明

腾讯混元图像服务状态接口提供腾讯混元（Hunyuan）图像相关服务的实时可用性查询。在发起图像生成请求之前，先确认服务状态可以避免不必要的失败等待时间，提升开发体验。

QuickRouter 会在控制台和 API 层面展示各服务的健康状态，建议在业务代码中加入服务状态预检逻辑，提高请求成功率。

认证

Python 调用示例

import requests

url = "https://api.quickrouter.ai/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": "你好"
    }
  ]
}