---
description: "API Key 获取、SDK 兼容、计费与开票等高频问题速查。"
---

# 常见问题

## 接入相关

### 如何获取 API Key？

登录工作台后，在「密钥管理」页面创建。密钥格式为 `sk-xxxx`，兼容 OpenAI SDK。

### 支持哪些 SDK？

与 OpenAI 接口完全兼容，可直接使用：

- **OpenAI Python SDK**：`pip install openai`
- **OpenAI Node.js SDK**：`npm install openai`
- **LangChain**：通过 `ChatOpenAI` 类接入
- 其他兼容 OpenAI 接口的客户端均可使用

### 请求超时怎么办？

建议将超时时间设置为 60 秒以上。长上下文或复杂推理任务可能需要更长时间。流式响应（`stream: true`）可以减少感知延迟。

### 返回 402 错误是什么意思？

表示账户余额不足。请在工作台充值后再试。详见[定价详情](./pricing.md)。

### 如何切换模型？

在请求的 `model` 参数中指定模型 ID。所有可用模型见[模型目录](./models.md)。

## 计费相关

### 计费单位是什么？

- Chat 和 Embeddings 模型：按 Token 计费，单位为 **元 / 百万 Token**
- 图片生成：按次计费
- 音乐生成：按被接受的生成请求次数计费，状态查询不额外收费
- 语音转写：按输入音频时长计费，向上取整到秒
- 语音合成：按生成音频时长计费，向上取整到秒

### 缓存命中是什么？

当输入内容与历史请求的前缀匹配时，命中缓存的部分按折扣价计费，可显著降低成本。详见[定价详情](./pricing.md#缓存命中优惠)。

### 如何查看消费记录？

在工作台的「调用记录」页面可以查看每次 API 调用的详细费用明细。

### 有免费额度吗？

新用户首次登录可获得系统赠送的余额，可直接用于测试。

## 充值相关

### 支持哪些支付方式？

目前支持 **微信扫码支付**。

### 充值后余额没到账？

支付成功后余额通常实时到账。如遇延迟，请检查订单状态或联系客服。

### 充值金额有优惠吗？

有。充值 ¥100 以上可获得赠送比例，详见[账户与充值](./account.md#充值优惠)。

## 发票相关

### 可以开发票吗？

可以。在工作台的「发票」页面申请，支持增值税普通发票和增值税专用发票。详见[开票信息](./invoice.md)。

### 哪些订单可以开票？

已支付成功的订单均可开票，系统赠送金额不可开票。

## 安全相关

### API Key 泄露了怎么办？

立即在工作台的「密钥管理」页面删除泄露的密钥，重新创建一个新的。

### 密钥有有效期吗？

默认有效期为 3 年，创建时可自定义。过期后密钥自动失效。

### 一个账户可以创建多个密钥吗？

可以。建议为不同用途创建不同的密钥，便于权限隔离和用量追踪。

## 其他问题

### 有速率限制吗？

平台对 API 调用设有基本的频率限制，正常使用不会触发。

账户还设有独立的并发上限，同一账户下的所有 API Key 共享。你可以在个人中心的「并发额度」中查看当前上限；累计成功支付充值达到页面显示的门槛后，可以提交提额申请。充值赠金、邀请返利和管理员调账不计入该门槛，申请仍需经过人工审核。

### 支持哪些语言/地区？

API 接口支持全球访问，服务端在中国大陆。界面语言为中文。

### 如何联系我们？

如有其他问题，请通过工作台页面底部的联系方式与我们取得联系。