Menú de Docs
Referencia
Referencia de la APIFacturación
Por qué cobramos al recargarReferencia de la API
v1· Actualizado en jul 2026160+ modelos · 12 familias de modelos
WayJet es un gateway compatible con OpenAI. Apunta cualquier SDK de OpenAI a la URL base de abajo, usa una clave de API sk- y llama a todos los proveedores a través de una única API.
12 familias de modelos
OpenAI, Anthropic, Gemini, Groq y más, detrás de una sola API.
Compatible con OpenAI
Apunta cualquier SDK de OpenAI a la URL base, sin cambiar el código.
Streaming
SSE token a token en chat completions desde el primer momento.
Claves y presupuestos
Claves con alcance limitado, topes de gasto por periodo y seguimiento del uso.
Llama a GET /v1/models con tu clave para ver los modelos que te sirve el gateway.
Introducción#
Todas las peticiones van a una única URL base. Como el gateway habla el formato de OpenAI, los SDK y herramientas que ya usas funcionan sin cambios: solo cambias la URL base y la clave.
https://api.wayjet.ai/v1Autenticación#
Autentícate con un token Bearer en la cabecera Authorization. Crea una clave con el prefijo sk- en la página de claves de API: el secreto solo se muestra una vez, así que guárdalo en un lugar seguro.
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
Inicio rápido#
Envía tu primer chat completion. Asigna tu clave de API a WAYJET_API_KEY y ejecútalo tal cual, o cambia gpt-5.1 por cualquier id de modelo de GET /v1/models, que lista los modelos que tu clave puede llamar.
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: el endpoint principal. Las peticiones y respuestas siguen el esquema de OpenAI; el gateway añade provider y cache_status a la respuesta.
| Parámetro | Tipo | Descripción |
|---|---|---|
| model* | string | Un id de modelo de GET /v1/models (gpt-5.1 en los ejemplos) |
| messages* | array | Mensajes de la conversación (role + content) |
| stream | boolean | Devuelve los tokens como server-sent events |
| temperature | number | Temperatura de muestreo, 0–2 (por defecto 1) |
| max_tokens | integer | Máximo de tokens a generar |
| top_p | number | Masa de probabilidad del muestreo de núcleo |
| tools | array | Definiciones de funciones/herramientas que el modelo puede llamar |
| tool_choice | string | object | Fuerza o restringe la elección de herramienta |
| response_format | object | p. ej. { "type": "json_object" } para el modo JSON |
| reasoning_effort | string | low · medium · high (modelos de razonamiento) |
| stop | string | array | Hasta 4 secuencias de parada |
| seed | integer | Muestreo determinista en la medida de lo posible |
| provider | string | Solo del gateway: fija la petición a un proveedor |
* obligatorio
Streaming#
Indica stream: true para recibir los tokens como server-sent events. Cada evento es una línea data: con un delta; el flujo termina con 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]Caché de prompts#
Varios proveedores guardan en caché el prefijo de un prompt que han visto hace poco y cobran menos por volver a procesarlo. En OpenAI, Gemini y DeepSeek esto ocurre automáticamente: no necesita ningún parámetro tuyo, y ni tú ni WayJet podéis desactivarlo. Anthropic solo guarda en caché cuando la petición lo pide.
Con la clave de la plataforma, WayJet solo respeta `cache_control` en las cuentas fijadas a su propio espacio de trabajo de Anthropic. En los demás casos el marcador se acepta y se elimina antes de que la petición llegue a Anthropic. La llamada funciona igual, pero su usage no incluye tokens de caché y cada token de entrada se cobra a la tarifa de entrada completa, que es también lo que Anthropic cobra por él. Con tu propia clave de Anthropic, el marcador siempre pasa.
Cada proveedor traza el límite de la caché en su propio cliente. Con una clave de la plataforma WayJet, ese cliente es WayJet, así que en los tres proveedores automáticos tus peticiones comparten un espacio de caché con otras cuentas de WayJet durante la ventana de reutilización de abajo. El gateway devuelve cache_status en chat completions, pero indica si se reutilizó un prefijo, no de quién era.
| Proveedor | Caché | Límite de la caché | Ventana de reutilización |
|---|---|---|---|
| OpenAI | Automática | La organización: la de WayJet, con la clave de la plataforma | hasta 30 min |
| Gemini | Automática | El proyecto de Google Cloud: el de WayJet, con la clave de la plataforma | hasta 24 h |
| DeepSeek | Automática | La cuenta: la de WayJet, con la clave de la plataforma | de horas a días |
| Anthropic | Bajo petición (cache_control), con tu propia clave o una cuenta fijada | Tu propia cuenta (BYOK) o tu espacio de trabajo fijado | 5 min |
| Claude en Bedrock / Vertex | Bajo petición, solo con credenciales propias | La cuenta de AWS / el proyecto de GCP | 5 min |
Qué significa y qué no significa una caché compartida
Ningún contenido de prompts o respuestas atraviesa una caché de prompts. Un acierto de caché es el proveedor volviendo a procesar, más barato, un prefijo que el propio llamante ya envió: no entrega el texto de nadie a nadie. Lo que sí expone un espacio compartido es el tiempo: alguien que ya tenga un prefijo exacto podría, en teoría, deducir de una respuesta más rápida o más barata que se envió hace poco. Primero tiene que conocer el prefijo, y eso es lo que acota el riesgo.
Lo publicamos porque tú no puedes observarlo. WayJet oculta a propósito qué proveedor atendió cada petición, así que nada en la API ni en el panel te diría dónde está el límite de la caché de un proveedor. Si revendes inferencia a tus propios usuarios, esta es la respuesta a la misma pregunta un nivel más abajo.
Si necesitas un espacio de caché propio
Hay dos vías, y son las únicas honestas: no existe ningún ajuste por cliente en la clave de la plataforma que lo consiga.
- Usa tu propia clave. Añade tus propias credenciales del proveedor y tu tráfico irá con tu cuenta en el proveedor, con el límite de la caché trazado en ti. Funciona con todos los proveedores y es la solución completa.
- Pide un espacio de trabajo de Anthropic. Solo para Anthropic, podemos fijar tu cuenta a su propio espacio de trabajo de Anthropic, de modo que tu caché de prompts sea solo tuya mientras sigues usando la clave de la plataforma. Se activa a petición y por cuenta: no hay interruptor de autoservicio, y no se aplica a Claude a través de Bedrock o Vertex, que no tienen equivalente. También es lo que activa la caché de Anthropic en una cuenta con clave de la plataforma.
Embeddings#
POST /v1/embeddings: vectoriza texto para búsqueda y RAG. Acepta una cadena o un array de cadenas.
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"
}'Audio (voz)#
POST /v1/audio/speech convierte texto en voz (se cobra por carácter de entrada) y POST /v1/audio/transcriptions convierte un archivo de audio en texto (se cobra por minuto de audio). Ambos son compatibles con OpenAI.
Texto a voz
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.mp3Voz a texto
Sube el archivo como multipart/form-data. Indica srt, vtt o verbose_json en response_format para obtener subtítulos con marcas de tiempo en lugar de texto plano.
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 devuelve el catálogo disponible para tu clave, cada modelo con su precio y sus capacidades. Usa un id de esta lista como model en todos los ejemplos de esta página.
curl https://api.wayjet.ai/v1/models \ -H "Authorization: Bearer $WAYJET_API_KEY"
Herramientas CLI (Claude Code, Codex)#
El gateway habla la API Messages de Anthropic (POST /v1/messages) y la API Responses de OpenAI (POST /v1/responses), así que las CLI de programación más populares apuntan directamente a WayJet y facturan con tu propia clave: sin proxy y sin SDK de cada proveedor. Apunta cada herramienta a un modelo que puedas llamar.
¿Qué es un squad?
Un squad es un nombre de modelo que llamas: un producto con nombre en el gateway que responde bajo ese nombre. Usa un nombre de squad en cualquier sitio donde vaya un nombre de modelo. GET /v1/models lista los que tu clave puede llamar. Los nombres de modelo de las configuraciones de abajo son squads, así que funcionan tal cual.
Claude Code
Añádelo a ~/.claude/settings.json. La clave va en ANTHROPIC_AUTH_TOKEN (o en ANTHROPIC_API_KEY como cabecera x-api-key), y cada nivel se asigna al modelo que elijas.
{
"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
Codex usa por defecto la API Responses de OpenAI: no hace falta 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"
}Claude Code y Codex envían cada petición al único modelo que nombran.
Errores#
Los errores usan códigos de estado HTTP estándar y una estructura al estilo de OpenAI.
{
"error": {
"message": "Incorrect API key provided.",
"type": "authentication_error",
"code": null,
"param": null
}
}| Estado | Tipo | Significado |
|---|---|---|
| 200 | OK | La petición se completó |
| 400 | invalid_request_error | Petición mal formada o parámetros no válidos |
| 401 | authentication_error | Clave de API ausente, no válida o revocada |
| 403 | permission_error | La clave no tiene permiso para esta acción |
| 404 | not_found_error | Modelo o recurso desconocido |
| 429 | rate_limit_error | Se alcanzó un límite de frecuencia o se superó un presupuesto |
| 500 | api_error | Error inesperado del gateway |
Endpoints#
Los endpoints que puedes llamar con una clave de API. Las claves, el uso y los presupuestos se gestionan desde el panel.
| Método | Endpoint | Descripción |
|---|---|---|
| POST | /v1/chat/completions | Chat completion (con y sin streaming) |
| POST | /v1/messages | Formato Messages de Anthropic (con y sin streaming; x-api-key o Bearer) |
| POST | /v1/responses | Formato Responses de OpenAI (con y sin streaming). Sin estado: previous_response_id se ignora, así que envía la conversación completa cada vez |
| GET | /v1/generation | Coste y tokens de una petición, por su X-Wayjet-Request-Id (?id=) |
| POST | /v1/embeddings | Crear embeddings |
| POST | /v1/audio/speech | Texto a voz (sale audio) |
| POST | /v1/audio/transcriptions | Voz a texto (transcripción) |
| GET | /v1/models | Listar los modelos disponibles |
Registro de cambios#
Cambios destacados de la API pública. La URL base sigue siendo /v1 por compatibilidad.
- jul 2026Herramientas CLI: usa Claude Code (/v1/messages) y Codex (/v1/responses) directamente. Estadísticas de generación (/v1/generation).
- jul 2026Audio: texto a voz (/v1/audio/speech) y voz a texto (/v1/audio/transcriptions, con formatos srt/vtt/verbose_json).
- jun 2026Se añade reasoning_effort.
- may 2026Endpoint de embeddings y modo JSON (response_format).
- abr 2026Streaming (SSE) en chat completions; fijación de proveedor.

