Pular para o conteúdo

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.

Gerenciar minhas chaves
app.ts
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 ?? "");}
Terminal
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/models

Lista modelos habilitados e seus recursos disponíveis.

POST/v1/chat/completions

Formato OpenAI Chat Completions, com streaming e chamadas de ferramentas.

POST/v1/responses

Formato OpenAI Responses, usado pelo Codex CLI.

POST/v1/messages

Formato 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.

response.json
{  "error": {    "code": "MODEL_UNAVAILABLE",    "message": "The requested model is temporarily unavailable."  },  "request_id": "<request-id>"}

Consumo e preços

Cada chamada aceita mantém uma cópia do preço. O saldo é reservado antes da execução e você paga só o uso confirmado. Se a chamada falhar sem uso, a reserva volta inteira para o seu saldo.