API Reference

Complete reference for the ShuttleAI REST API.

The ShuttleAI API is fully OpenAI-compatible. If your code works with OpenAI, it works with ShuttleAI — just change the base URL and API key.

Base URL

https://api.shuttleai.com/v1

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer shuttle-xxx

Get your API key from the Dashboard.

SDKs

ShuttleAI works with any OpenAI-compatible SDK:

Python (OpenAI SDK)

pip install openai

npm install openai

Python

from openai import OpenAI

client = OpenAI(
    api_key="shuttle-xxx",
    base_url="https://api.shuttleai.com/v1"
)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "shuttle-xxx",
  baseURL: "https://api.shuttleai.com/v1",
});

Available endpoints

Endpoint	Method	Description
/v1/chat/completions	POST	Generate text completions
/v1/models	GET	List all available models
/v1/models/{id}	GET	Get details for a specific model

Response format

All endpoints return JSON. Successful responses use standard HTTP 200. Errors return the appropriate HTTP status code with an error object:

{
  "error": {
    "message": "Error description",
    "type": "error_type",
    "code": 400
  }
}

See Error Codes for a complete reference.

Rate limits

Rate limits depend on your plan:

Plan	Requests/minute
Free	2
Basic	10
Premium	30
Scale	80

Some models have multipliers that consume more than 1 request per call.