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

# FAQ

> BizyAir 常见问答：API Key、调用模式、计费、退款、输出文件有效期与并发限制

## 账户与 API Key

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

登录 bizyair.ai → 设置 → API 密钥 → 点击「新建API密钥」→ 复制生成的 48 位 Key。

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

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

## 调用模式

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

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

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

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

## 计费

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

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

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

返回 `{"code": 20049, "message": "Insufficient account balance"}`，任务无法提交。请先充值。

## 付款收据与发票

**Q: 在哪可以查看或下载付款收据与发票？**

进入[充值页面](https://www.bizyair.ai/user/topup/checkout)，在订单列表中点击「获取发票」即可下载付款收据或发票。详见《服务条款》第 1.13 及 1.14 条关于"付款收据"与"发票"的定义。

## 输出文件

**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-environment-updates)中发布。

## 安装与配置

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

BizyAir CLI 是 Go 编写的二进制工具，请从 [GitHub Releases](https://github.com/siliconflow/bizyair-cli/releases) 下载对应平台的安装包，或参考 [命令行工具文档](/cn/api-guide/bizyair-cli) 中的安装步骤。

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