# Sylica API Docs (Machine Readable)

Version: v1
Base URL (recommended): https://api.sylicaai.com/v1
Base URL (compat): https://api.sylicaai.com
Auth: Authorization: Bearer <SYLICA_API_KEY>
Key prefix: sk-sylica-

## Human Documentation Sections
- /docs/overview
- /docs/quickstart
- /docs/authentication
- /docs/endpoints
- /docs/chat-completions
- /docs/streaming
- /docs/routing
- /docs/errors-retries
- /docs/billing-credits
- /docs/production-readiness

## Endpoints
- POST /chat/completions
- GET /models
- GET /credits

## Chat Request (OpenAI compatible)
Required:
- model: string
- messages: array

Optional:
- stream: boolean (default false)
- temperature: number (0..2)
- top_p: number (0..1)
- max_tokens: positive integer
- stop: string or string[]
- tools: array
- tool_choice: string or object
- response_format: object
- reasoning_effort: low|medium|high
- user: string
- provider: object

## Sylica Routing Extensions
provider.order: string[] (preferred provider order)
provider.require: string[] (provider allow-list)
provider.allow_fallbacks: boolean

## Meta Models
- sylica/auto
- sylica/cheapest
- sylica/fastest

## Streaming
When stream=true:
- Response content-type: text/event-stream
- Event lines: data: <json>
- Terminal sentinel: data: [DONE]

## Error Codes
- invalid_request (400)
- authentication_error (401)
- permission_denied (403)
- not_found (404)
- insufficient_credits (402)
- rate_limited (429)
- upstream_error (502)
- timeout (504)
- internal_error (500)

## Response Headers
- x-sylica-request-id
- x-ratelimit-limit
- x-ratelimit-remaining
- retry-after (on 429)