API 概览
TurboAPI REST API 概览。
TurboAPI 提供统一接口，通过简单的 REST API 访问多个 AI 服务。
基础 URL
https://api.turboapi.ai/api/v1
认证
所有 API 请求都需要在 Authorization 标头中包含 API 密钥：
Authorization: Bearer YOUR_API_KEY
速率限制
| 计划 | 每分钟请求数 | 每日请求数 |
|---|---|---|
| 免费版 | 60 | 1,000 |
| 专业版 | 300 | 50,000 |
| 企业版 | 无限制 | 无限制 |
响应格式
所有响应均为 JSON 格式：
{
"success": true,
"data": { ... },
"meta": {
"request_id": "req_123",
"latency_ms": 45
}
}
错误处理
API 使用标准 HTTP 状态码：
| 状态码 | 含义 |
|---|---|
| 200 | 成功 |
| 400 | 错误请求 |
| 401 | 未授权 |
| 403 | 禁止访问 |
| 429 | 请求过多 |
| 500 | 服务器错误 |
可用端点
核心服务
| 端点 | 方法 | 描述 |
|---|---|---|
/api/v1/call | POST | 创建并执行任务 |
/api/v1/call | GET | 获取任务状态 |
/api/v1/tasks | GET | 列出任务列表 |
/api/v1/tasks/:id | GET | 获取任务详情 |
/api/v1/apis | GET | 浏览可用 API |
/api/v1/apis/:slug | GET | 获取 API 详情 |
管理端点
| 端点 | 方法 | 描述 |
|---|---|---|
/api/v1/tasks | GET | 查看任务历史 |
/api/v1/tasks/:id/cancel | POST | 取消进行中的任务 |
SDK 支持
我们提供多种编程语言的 SDK：
Node.js / TypeScript
npm install @turboapiai/sdk
import { TurboAPIClient } from '@turboapiai/sdk';
const client = new TurboAPIClient({
apiKey: process.env.TURBOAPI_API_KEY,
});
Python
pip install turboapi-sdk
from turboapi import TurboAPIClient
client = TurboAPIClient(api_key="your_api_key")
Go
go get github.com/turboapiai/turboapi-sdk-go
import turboapi "github.com/turboapiai/turboapi-sdk-go"
client := turboapi.NewClient("YOUR_API_KEY")
cURL
curl https://api.turboapi.ai/api/v1/apis \
-H "Authorization: Bearer YOUR_API_KEY"
版本控制
API 版本在 URL 中指定：
- v1：当前稳定版本
查看我们的示例了解如何使用这些端点。