Documentação para desenvolvedores
Da chave à primeira chamada.
Uma API familiar, com limites claros. Comece com geração de texto e use apenas os recursos disponíveis para o modelo escolhido.
1. Crie uma chave
Crie sua conta e gere uma chave no painel. Copie o segredo quando aparecer: ele não poderá ser consultado depois.
2. Confira disponibilidade e saldo
Use um ID de modelo retornado por GET /v1/models. A execução exige modelo disponível, saldo suficiente e integração habilitada.
3. Faça uma chamada
Use o endereço da API dos exemplos abaixo. Chaves de API ficam no seu servidor, nunca em código público do navegador.
import OpenAI from "openai";const apiKey = process.env.SEATROUTER_API_KEY;const baseURL = process.env.SEATROUTER_API_BASE_URL; // https://seatrouter-backend-3a84315efa9e.herokuapp.com/v1const model = process.env.SEATROUTER_MODEL_ID;if (!apiKey || !baseURL || !model) { throw new Error("SeatRouter configuration is required.");}const client = new OpenAI({ apiKey, baseURL, maxRetries: 0,});const response = await client.chat.completions.create({ model, messages: [{ role: "user", content: "Hello!" }], max_completion_tokens: 1024, stream: true,});for await (const event of response) { process.stdout.write(event.choices[0]?.delta?.content ?? "");}export SEATROUTER_API_BASE_URL=https://seatrouter-backend-3a84315efa9e.herokuapp.com/v1curl "$SEATROUTER_API_BASE_URL/chat/completions" \ -H "Authorization: Bearer $SEATROUTER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "<available-model-id>", "messages": [{"role": "user", "content": "Hello!"}], "max_completion_tokens": 1024, "stream": true }'Exemplo de configuração. Substitua todos os campos de exemplo antes de usar.
A API inicial
GET/v1/modelsLista modelos habilitados e seus recursos disponíveis.
POST/v1/chat/completionsFormato OpenAI Chat Completions, com streaming e chamadas de ferramentas.
POST/v1/responsesFormato OpenAI Responses, usado pelo Codex CLI.
POST/v1/messagesFormato Anthropic Messages, usado pelo Claude Code.
Fora da API inicial: embeddings, áudio, vídeo e arquivos persistentes.
Um stream só termina quando termina
HTTP 200 não comprova uma resposta completa. Trate erros terminais e conexões interrompidas. O SeatRouter não une outra geração silenciosamente a uma resposta parcial.
Erros previsíveis
Códigos de erro e mensagens técnicas da API são estáveis e não são traduzidos. Use request_id no suporte. Não inclua pedidos, respostas ou segredos.
{ "error": { "code": "MODEL_UNAVAILABLE", "message": "The requested model is temporarily unavailable." }, "request_id": "<request-id>"}