API reference
Endpoints expostos pelo ForgeRouter e formato de resposta.
POST /v1/chat/completions
Compatível com o formato OpenAI. Campos aceitos:
| Campo | Tipo | Descrição |
|---|---|---|
model | string | ID do modelo, ou "auto" para deixar o ForgeRouter escolher. |
messages | array | Lista de mensagens no formato {role, content}. |
stream | boolean | Se true, a resposta é enviada como SSE. |
Resposta (não-streaming):
{
"id": "chatcmpl-...",
"model_used": "meu-provedor-principal:modelo-grande",
"choices": [{ "message": { "role": "assistant", "content": "..." } }]
}O campo model_used informa qual provedor real atendeu a chamada — útil pra auditoria e
debugging de custo.
GET /v1/models
Lista os modelos disponíveis entre todos os provedores ativos, no formato OpenAI ({data: [...]}).
POST /v1/messages
Tradutor para o formato Anthropic Messages API. Aceita o mesmo corpo que a API oficial da
Anthropic; internamente é convertido para o pipeline de /v1/chat/completions e a resposta é
traduzida de volta ao formato Anthropic antes de retornar.
POST /v1/responses
Tradutor para o formato OpenAI Responses API, com o mesmo princípio do endpoint acima.
Autenticação
Todos os endpoints exigem Authorization: Bearer <FORGEROUTER_API_KEY> — a chave configurada no
deploy (ver Instalação), não a chave de nenhum provedor
individual.