> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizyair.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

## 账户与 API Key

**Q: 如何获取 API Key？**

登录 bizyair.ai → 个人中心 → API Keys → 点击「创建新 Key」→ 复制生成的 48 位 Key（仅显示一次，请妥善保存）。

**Q: API Key 泄露了怎么办？**

立即在个人中心禁用旧 Key 并创建新 Key。切勿将 Key 提交到 Git、写入前端代码或分享到公开渠道。

## 调用模式

**Q: 同步、异步、WebHook 三种模式有什么区别？**

| 模式      | 适用场景             | 说明                      |
| ------- | ---------------- | ----------------------- |
| 同步阻塞    | 短任务（\< 60s）、简单调试 | 连接保持打开直到任务完成            |
| 异步查询    | 长任务、网络不稳定        | 立即返回 `request_Id`，客户端轮询 |
| WebHook | 生产环境、高并发         | 任务完成后主动 POST 回调         |

**Q: 同步调用超时了怎么办？**

确保 HTTP 客户端的读取超时 ≥ 60 秒。如超时，任务可能仍在云端完成，可用 requestId 通过 /detail 接口查询状态。

## 计费

**Q: 任务取消后还计费吗？**

排队中（Queuing）和准备中（Preparing）取消免费。运行中（Running）中断，已运行部分仍计费。平台原因中断免费。

**Q: 余额不足时会怎样？**

返回 `{"code": 42901, "message": "insufficient credits"}`，任务无法提交。请先充值。

## 输出文件

**Q: 生成的结果文件有效期多久？**

输出文件（object\_url）默认有效期 15 天，过期后无法恢复。建议生成后立即下载到自有存储。

## 并发限制

**Q: 如何提高并发数？**

升级套餐等级（`设置`→`余额与权益` ），或联系商务 [contact@bizyair.ai](mailto:contact@bizyair.ai)。

**Q: 返回 429 怎么办？**

降低并发数，使用指数退避重试，或升级套餐。

## ComfyUI 节点缺失

**Q: 节点缺失怎么办？**

请访问填写 [反馈问卷](https://docs.google.com/forms/d/e/1FAIpQLScRGvcfuSoEfDYdIos82_-VZmg6AN9vJogsl908hv6OQbDM2g/viewform?usp=send_form)，更新后的节点会在[ComfyUI 新增插件公示](/cn/comfyui-new-nodes)

## 订单与发票

**Q: 如何开发票？**

进入个人中心 → 账单 → 申请开票，提供有效税务登记号，平台将在 3 个工作日内开具电子发票。

## 安装与配置

**Q: BizyAir CLI 怎么安装？**

```bash theme={null}
pip install bizyair
```

详见 [命令行工具文档](/cn/api-guide/bizyair-cli)。