API 概览
TurboAPI REST API 概览。
API 概览
TurboAPI 提供统一接口，通过简单的 REST API 访问多个 AI 服务。
基础 URL
https://api.turboapi.ai/v1
认证
所有 API 请求都需要在 Authorization 标头中包含 API 密钥：
Authorization: Bearer YOUR_API_KEY
速率限制
| 计划 | 每分钟请求数 | 每日请求数 |
|---|---|---|
| 免费版 | 60 | 1,000 |
| 专业版 | 300 | 50,000 |
| 企业版 | 无限制 | 无限制 |
响应格式
所有响应均为 JSON 格式：
{
"data": { ... },
"usage": {
"prompt_tokens": 10,
"completion_tokens": 5,
"total_tokens": 15
},
"model": "gpt-4",
"created": 1677652288
}
错误处理
API 使用标准 HTTP 状态码：
| 状态码 | 含义 |
|---|---|
| 200 | 成功 |
| 400 | 错误请求 |
| 401 | 未授权 |
| 403 | 禁止访问 |
| 429 | 请求过多 |
| 500 | 服务器错误 |
可用端点
核心服务
| 端点 | 方法 | 描述 |
|---|---|---|
/models | GET | 列出可用模型 |
/completions | POST | 创建文本补全 |
/chat/completions | POST | 创建聊天补全 |
/images/generate | POST | 生成图像 |
/audio/transcribe | POST | 音频转文字 |
/audio/speech | POST | 文字转音频 |
管理端点
| 端点 | 方法 | 描述 |
|---|---|---|
/usage | GET | 获取使用统计 |
/billing/subscription | GET | 获取订阅信息 |
/billing/invoices | GET | 获取账单历史 |
SDK 支持
我们提供多种编程语言的 SDK：
Node.js / TypeScript
npm install @turboapi/sdk
import { TurboAPI } from '@turboapi/sdk';
const client = new TurboAPI({
apiKey: process.env.TURBOAPI_API_KEY,
});
Python
pip install turboapi-python
from turboapi import TurboAPI
client = TurboAPI(api_key="your_api_key")
cURL
curl https://api.turboapi.ai/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"
版本控制
API 版本在 URL 中指定：
- v1：当前稳定版本
- v2：测试版本（邀请制）
支持的模型
文本生成
| 模型 | 描述 | 最大令牌 |
|---|---|---|
| gpt-4 | 最强大的模型 | 8,192 |
| gpt-4-turbo | 更快的 GPT-4 | 128,000 |
| gpt-3.5-turbo | 经济高效的模型 | 4,096 |
图像生成
| 模型 | 描述 | 最大尺寸 |
|---|---|---|
| dall-e-3 | 最新的图像生成模型 | 1024×1024 |
| dall-e-2 | 经典图像生成模型 | 512×512 |
查看我们的示例了解如何使用这些端点。