Documentação

Endpoints da API v1, autenticação e exemplos.

Autenticação

Todas as rotas de /api/v1/* exigem header:

Authorization: Bearer sk-railter-XXXXXXXXXXXXXXXX

Crie keys no dashboard em Projetos → [seu projeto] → API Keys.

POST /api/v1/llm/chat

Chat completion via Claude, GPT-4o e outros. Suporta streaming SSE.

{
  "model": "claude-sonnet-4-6",
  "messages": [
    {"role": "system", "content": "Você é útil."},
    {"role": "user", "content": "Olá!"}
  ],
  "stream": true,
  "temperature": 0.7,
  "max_tokens": 1024
}

GET /api/v1/llm/models

Lista os modelos disponíveis.

POST /api/v1/mail/send

Envia email transacional via Mailder.

{
  "from": "[email protected]",
  "to": ["[email protected]"],
  "subject": "Assunto",
  "html": "<p>Mensagem</p>"
}

GET /api/v1/usage

Resumo de uso da API key atual + últimas 100 requests.

GET /api/v1/keys/me

Info da API key sendo usada (scopes, limits, projeto, organização).