Menu dos Docs
Referência
Referência da APICobrança
Por que cobramos na recargaReferência da API
v1· Atualizado em jul. de 2026160+ modelos · 12 famílias de modelos
A WayJet é um gateway compatível com a OpenAI. Aponte qualquer SDK da OpenAI para a URL base abaixo, use uma chave de API sk- e chame todos os provedores por uma única API.
12 famílias de modelos
OpenAI, Anthropic, Gemini, Groq e mais, atrás de uma única API.
Compatível com a OpenAI
Aponte qualquer SDK da OpenAI para a URL base, sem mudar o código.
Streaming
SSE token a token em chat completions, pronto para usar.
Chaves e orçamentos
Chaves com escopo, limites de gasto por período e acompanhamento do uso.
Chame GET /v1/models com a sua chave para listar os modelos que o gateway oferece.
Introdução#
Toda requisição vai para uma única URL base. Como o gateway fala o formato da OpenAI, os SDKs e ferramentas que você já usa funcionam sem mudanças: basta trocar a URL base e a chave.
https://api.wayjet.ai/v1Autenticação#
Autentique-se com um token Bearer no cabeçalho Authorization. Crie uma chave com o prefixo sk- na página de chaves de API: o segredo aparece só uma vez, então guarde-o em um lugar seguro.
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
Início rápido#
Envie o seu primeiro chat completion. Defina WAYJET_API_KEY com a sua chave de API e rode como está, ou troque gpt-5.1 por qualquer id de modelo de GET /v1/models, que lista os modelos que a sua chave pode chamar.
curl https://api.wayjet.ai/v1/chat/completions \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.1",
"messages": [{"role": "user", "content": "Hello"}]
}'Chat completions#
POST /v1/chat/completions: o endpoint principal. Requisições e respostas seguem o esquema da OpenAI; o gateway acrescenta provider e cache_status à resposta.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| model* | string | Um id de modelo de GET /v1/models (gpt-5.1 nos exemplos) |
| messages* | array | Mensagens da conversa (role + content) |
| stream | boolean | Devolve os tokens como server-sent events |
| temperature | number | Temperatura de amostragem, 0–2 (padrão 1) |
| max_tokens | integer | Máximo de tokens a gerar |
| top_p | number | Massa de probabilidade da amostragem nucleus |
| tools | array | Definições de funções/ferramentas que o modelo pode chamar |
| tool_choice | string | object | Força ou restringe a escolha de ferramenta |
| response_format | object | ex.: { "type": "json_object" } para o modo JSON |
| reasoning_effort | string | low · medium · high (modelos de raciocínio) |
| stop | string | array | Até 4 sequências de parada |
| seed | integer | Amostragem determinística na medida do possível |
| provider | string | Exclusivo do gateway: fixa a requisição em um provedor |
* obrigatório
Streaming#
Defina stream: true para receber os tokens como server-sent events. Cada evento é uma linha data: com um delta; o fluxo termina com data: [DONE].
curl https://api.wayjet.ai/v1/chat/completions \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.1",
"messages": [{"role": "user", "content": "Hello"}],
"stream": true
}'
# → server-sent events: lines of data: {...} terminated by data: [DONE]Cache de prompts#
Vários provedores guardam em cache o início de um prompt visto recentemente e cobram menos para processá-lo de novo. Na OpenAI, no Gemini e no DeepSeek isso acontece automaticamente: não precisa de nenhum parâmetro seu, e nem você nem a WayJet podem desativar. A Anthropic só usa cache quando a requisição pede.
Com a chave da plataforma, a WayJet só respeita `cache_control` em contas fixadas ao próprio workspace da Anthropic. Nos outros casos, o marcador é aceito e removido antes de a requisição chegar à Anthropic. A chamada funciona, mas o seu usage não traz tokens de cache e todo token de entrada é cobrado pela tarifa de entrada cheia, que é também o que a Anthropic cobra por ele. Com a sua própria chave da Anthropic, o marcador sempre passa.
Cada provedor traça o limite do cache no seu próprio cliente. Com uma chave da plataforma WayJet, esse cliente é a WayJet; por isso, nos três provedores automáticos, as suas requisições compartilham um espaço de cache com outras contas da WayJet durante a janela de reuso abaixo. O gateway devolve cache_status nos chat completions, mas ele indica se um prefixo foi reutilizado, não de quem era.
| Provedor | Cache | Limite do cache | Janela de reuso |
|---|---|---|---|
| OpenAI | Automático | A organização: a da WayJet, com a chave da plataforma | até 30 min |
| Gemini | Automático | O projeto do Google Cloud: o da WayJet, com a chave da plataforma | até 24 h |
| DeepSeek | Automático | A conta: a da WayJet, com a chave da plataforma | de horas a dias |
| Anthropic | Sob demanda (cache_control), com a sua própria chave ou uma conta fixada | A sua própria conta (BYOK) ou o seu workspace fixado | 5 min |
| Claude no Bedrock / Vertex | Sob demanda, só com credenciais próprias | A conta da AWS / o projeto do GCP | 5 min |
O que um cache compartilhado significa e o que não significa
Nenhum conteúdo de prompt ou de resposta atravessa um cache de prompts. Um acerto de cache é o provedor processando de novo, mais barato, um prefixo que o próprio chamador já enviou: não entrega o texto de ninguém a ninguém. O que um espaço compartilhado expõe é o tempo: alguém que já tenha um prefixo exato poderia, em teoria, deduzir de uma resposta mais rápida ou mais barata que ele foi enviado há pouco. Primeiro é preciso conhecer o prefixo, e é isso que limita o risco.
Publicamos isso porque você não consegue observar sozinho. A WayJet esconde de propósito qual provedor atendeu cada requisição, então nada na API ou no painel diria onde fica o limite do cache de um provedor. Se você revende inferência para os seus próprios usuários, esta é a resposta para a mesma pergunta, um nível abaixo.
Se você precisa de um espaço de cache só seu
Há dois caminhos, e são os únicos honestos: não existe nenhuma configuração por cliente na chave da plataforma que faça isso.
- Use a sua própria chave. Adicione as suas próprias credenciais do provedor e o seu tráfego passa pela sua conta no provedor, com o limite do cache traçado em você. Funciona em todos os provedores e é a resposta completa.
- Peça um workspace da Anthropic. Só para a Anthropic, podemos fixar a sua conta em um workspace próprio da Anthropic, para que o seu cache de prompts seja só seu enquanto você continua usando a chave da plataforma. É sob pedido e ativado por conta: não há chave de autoatendimento, e não vale para o Claude acessado pelo Bedrock ou pelo Vertex, que não têm equivalente. É também o que ativa o cache da Anthropic para uma conta na chave da plataforma.
Embeddings#
POST /v1/embeddings: vetoriza texto para busca e RAG. Aceita uma string ou um array de strings.
curl https://api.wayjet.ai/v1/embeddings \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "your-embedding-model",
"input": "The quick brown fox"
}'Áudio (voz)#
POST /v1/audio/speech transforma texto em voz (cobrado por caractere de entrada), e POST /v1/audio/transcriptions transforma um arquivo de áudio em texto (cobrado por minuto de áudio). Os dois são compatíveis com a OpenAI.
Texto para fala
curl https://api.wayjet.ai/v1/audio/speech \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "your-tts-model",
"input": "The quick brown fox jumped over the lazy dog.",
"voice": "alloy"
}' \
--output speech.mp3Fala para texto
Envie o arquivo como multipart/form-data. Defina response_format como srt, vtt ou verbose_json para receber legendas com marcação de tempo em vez de texto puro.
curl https://api.wayjet.ai/v1/audio/transcriptions \ -H "Authorization: Bearer $WAYJET_API_KEY" \ -F "model=your-stt-model" \ -F "file=@audio.mp3" \ -F "response_format=json" # json (default) · text · srt · vtt · verbose_json
Modelos#
GET /v1/models devolve o catálogo disponível para a sua chave, cada modelo com preço e capacidades. Use um id dessa lista como model em todos os exemplos desta página.
curl https://api.wayjet.ai/v1/models \ -H "Authorization: Bearer $WAYJET_API_KEY"
Ferramentas CLI (Claude Code, Codex)#
O gateway fala a API Messages da Anthropic (POST /v1/messages) e a API Responses da OpenAI (POST /v1/responses), então as CLIs de programação mais usadas apontam direto para a WayJet e cobram pela sua própria chave, sem proxy nem SDK de cada provedor. Aponte cada ferramenta para um modelo que você pode chamar.
O que é um squad?
Um squad é um nome de modelo que você chama: um produto com nome no gateway, que responde com esse nome. Use um nome de squad em qualquer lugar onde vai um nome de modelo. GET /v1/models lista os que a sua chave pode chamar. Os nomes de modelo das configurações abaixo são squads, então funcionam como estão.
Claude Code
Adicione ao ~/.claude/settings.json. A chave vai em ANTHROPIC_AUTH_TOKEN (ou em ANTHROPIC_API_KEY como cabeçalho x-api-key), e cada nível corresponde a um modelo à sua escolha.
{
"hasCompletedOnboarding": true,
"env": {
"ANTHROPIC_BASE_URL": "https://api.wayjet.ai",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
}
}Codex
O Codex usa a API Responses da OpenAI por padrão: não precisa de wire_api = "chat".
model = "gpt-5.1" model_provider = "wayjet" [model_providers.wayjet] name = "WayJet" base_url = "https://api.wayjet.ai/v1" wire_api = "responses"
{
"auth_mode": "apikey",
"OPENAI_API_KEY": "sk-your-key"
}O Claude Code e o Codex enviam cada requisição ao único modelo que nomeiam.
Erros#
Os erros usam códigos de status HTTP padrão e uma estrutura no estilo da OpenAI.
{
"error": {
"message": "Incorrect API key provided.",
"type": "authentication_error",
"code": null,
"param": null
}
}| Status | Tipo | Significado |
|---|---|---|
| 200 | OK | A requisição deu certo |
| 400 | invalid_request_error | Requisição malformada ou parâmetros inválidos |
| 401 | authentication_error | Chave de API ausente, inválida ou revogada |
| 403 | permission_error | A chave não tem permissão para esta ação |
| 404 | not_found_error | Modelo ou recurso desconhecido |
| 429 | rate_limit_error | Limite de taxa atingido, ou orçamento estourado |
| 500 | api_error | Erro inesperado do gateway |
Endpoints#
Os endpoints que você pode chamar com uma chave de API. Chaves, uso e orçamentos são gerenciados no painel.
| Método | Endpoint | Descrição |
|---|---|---|
| POST | /v1/chat/completions | Chat completion (com e sem streaming) |
| POST | /v1/messages | Formato Messages da Anthropic (com e sem streaming; x-api-key ou Bearer) |
| POST | /v1/responses | Formato Responses da OpenAI (com e sem streaming). Sem estado: previous_response_id é ignorado, então envie a conversa inteira a cada vez |
| GET | /v1/generation | Custo e tokens de uma requisição, pelo seu X-Wayjet-Request-Id (?id=) |
| POST | /v1/embeddings | Criar embeddings |
| POST | /v1/audio/speech | Texto para fala (sai áudio) |
| POST | /v1/audio/transcriptions | Fala para texto (transcrição) |
| GET | /v1/models | Listar os modelos disponíveis |
Registro de alterações#
Mudanças importantes da API pública. A URL base continua /v1 por compatibilidade.
- jul. de 2026Ferramentas CLI: use o Claude Code (/v1/messages) e o Codex (/v1/responses) diretamente. Estatísticas de geração (/v1/generation).
- jul. de 2026Áudio: texto para fala (/v1/audio/speech) e fala para texto (/v1/audio/transcriptions, com formatos srt/vtt/verbose_json).
- jun. de 2026reasoning_effort adicionado.
- mai. de 2026Endpoint de embeddings e modo JSON (response_format).
- abr. de 2026Streaming (SSE) em chat completions; fixação de provedor.

