API Overview
Overview of the TurboAPI REST API.
TurboAPI provides a unified interface to access multiple AI services through a simple REST API.
Base URL
https://api.turboapi.ai/api/v1
Authentication
All API requests require an API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Rate Limits
| Plan | Requests/min | Requests/day |
|---|---|---|
| Free | 60 | 1,000 |
| Pro | 300 | 50,000 |
| Enterprise | Unlimited | Unlimited |
Response Format
All responses are in JSON format:
{
"success": true,
"data": { ... },
"meta": {
"request_id": "req_123",
"latency_ms": 45
}
}
Error Handling
API uses standard HTTP status codes:
| Status | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 429 | Too Many Requests |
| 500 | Server Error |
Available Endpoints
Core Services
| Endpoint | Method | Description |
|---|---|---|
/api/v1/call | POST | Create and execute a task |
/api/v1/call/{task_id} | GET | Get task status |
/api/v1/tasks | GET | List tasks |
/api/v1/tasks/{id} | GET | Get task details |
/api/v1/apis | GET | Browse available APIs |
/api/v1/apis/{slug} | GET | Get API details |
Management
| Endpoint | Method | Description |
|---|---|---|
/api/v1/tasks | GET | View task history |
/api/v1/tasks/{id}/cancel | POST | Cancel a running task |
SDK Support
We provide official SDKs for popular languages:
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"
Versioning
API version is specified in the URL:
- v1: Current stable version
Check out our examples to see how to use these endpoints.