API Reference

Starscoo is fully OpenAI-compatible. Replace https://api.openai.com with https://api.starscoo.space in any OpenAI SDK.

Authentication

Pass your Starscoo API key as a Bearer token:

Authorization: Bearer sk-starscoo-xxxxxxxx

Chat Completions

POST /v1/chat/completions

curl https://api.starscoo.space/v1/chat/completions \
  -H "Authorization: Bearer $STARSCOO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }'

Supports streaming (SSE), temperature, max_tokens, system and all standard OpenAI chat fields.

List Models

GET /v1/models

curl https://api.starscoo.space/v1/models \
  -H "Authorization: Bearer $STARSCOO_KEY"

Error codes

401Missing or invalid API key.

403Key is revoked or suspended.

429Rate limit exceeded. Check X-RateLimit-* headers.

502Upstream provider error. Retry with exponential back-off.

SDK examples

OpenAI Python SDK:

from openai import OpenAI

client = OpenAI(
    api_key="sk-starscoo-xxxxxxxx",
    base_url="https://api.starscoo.space/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Full SDK docs and rate limit details: main docs page.