API Reference

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

All requests require a Bearer token in the Authorization header:

Authorization: Bearer shuttle-xxx

Get your API key from the Dashboard.

ShuttleAI works with any OpenAI-compatible SDK:

pip install openai

from openai import OpenAI

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

import OpenAI from "openai";

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

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

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 depend on your plan:

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