Kitta AI 文档
API 文档

API Key 认证

创建 Kitta AI API Key,使用 Bearer 令牌认证 Open API 请求,并在 API Playground 中验证配置。

认证

Kitta AI Open API 使用 Bearer API Key。API Key 用于识别账户、权限和 API 额度。

本平台使用在 Kitta AI 账户中创建的 API 密钥,也适用于通过本平台调用 Fish Audio 模型。该密钥与 Fish Audio 官方 API 密钥不同,不能互换使用。

Authorization: Bearer KITTA_API_KEY

在账户设置中创建 API Key,再到在线调试页验证接入:

请求要求

每个 Open API 请求都必须携带 Authorization。JSON 请求还需发送 Content-Type: application/json。

curl https://kittaai.com/api/open/v1/profile \
  -H "Authorization: Bearer KITTA_API_KEY"

API Key 只能保存在服务端密钥管理器或加密环境变量中。不要将其放入浏览器代码、移动端应用、公开仓库、日志、分析事件或面向客户的错误信息。

如果密钥可能泄露、成员离职或环境切换,应创建新密钥、部署并验证新配置,然后撤销旧密钥。

错误处理

状态码含义建议
401API Key 缺失、无效、已撤销或账户不可用停止重试并更新密钥
402API 额度不足提示充值或缩小批次
429请求受到限流使用退避重试;异步任务继续查询原任务 ID

请记录错误响应中的 requestId,便于支持人员定位请求。认证本身不消耗积分,但通过认证的媒体接口可能预扣或消耗 API 额度。