Menú de Docs

Referencia de la API

v1· Actualizado en jul 2026

160+ 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/v1

Autenticació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.

header
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
Nunca expongas una clave en código del lado del cliente. Llama al gateway desde tu servidor o a través de un proxy.
Crear una clave de API

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"}]
  }'
Pruébalo en el Playground

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ámetroTipoDescripción
model*stringUn id de modelo de GET /v1/models (gpt-5.1 en los ejemplos)
messages*arrayMensajes de la conversación (role + content)
streambooleanDevuelve los tokens como server-sent events
temperaturenumberTemperatura de muestreo, 0–2 (por defecto 1)
max_tokensintegerMáximo de tokens a generar
top_pnumberMasa de probabilidad del muestreo de núcleo
toolsarrayDefiniciones de funciones/herramientas que el modelo puede llamar
tool_choicestring | objectFuerza o restringe la elección de herramienta
response_formatobjectp. ej. { "type": "json_object" } para el modo JSON
reasoning_effortstringlow · medium · high (modelos de razonamiento)
stopstring | arrayHasta 4 secuencias de parada
seedintegerMuestreo determinista en la medida de lo posible
providerstringSolo 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.

ProveedorCachéLímite de la cachéVentana de reutilización
OpenAIAutomáticaLa organización: la de WayJet, con la clave de la plataformahasta 30 min
GeminiAutomáticaEl proyecto de Google Cloud: el de WayJet, con la clave de la plataformahasta 24 h
DeepSeekAutomáticaLa cuenta: la de WayJet, con la clave de la plataformade horas a días
AnthropicBajo petición (cache_control), con tu propia clave o una cuenta fijadaTu propia cuenta (BYOK) o tu espacio de trabajo fijado5 min
Claude en Bedrock / VertexBajo petición, solo con credenciales propiasLa cuenta de AWS / el proyecto de GCP5 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.mp3

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

shell
curl https://api.wayjet.ai/v1/models \
  -H "Authorization: Bearer $WAYJET_API_KEY"
Ver todos los modelos

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.

~/.claude/settings.json
{
  "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".

~/.codex/config.toml
model = "gpt-5.1"
model_provider = "wayjet"

[model_providers.wayjet]
name = "WayJet"
base_url = "https://api.wayjet.ai/v1"
wire_api = "responses"
~/.codex/auth.json
{
  "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.

json
{
  "error": {
    "message": "Incorrect API key provided.",
    "type": "authentication_error",
    "code": null,
    "param": null
  }
}
EstadoTipoSignificado
200OKLa petición se completó
400invalid_request_errorPetición mal formada o parámetros no válidos
401authentication_errorClave de API ausente, no válida o revocada
403permission_errorLa clave no tiene permiso para esta acción
404not_found_errorModelo o recurso desconocido
429rate_limit_errorSe alcanzó un límite de frecuencia o se superó un presupuesto
500api_errorError inesperado del gateway
Ver tu uso y tus límites

Endpoints#

Los endpoints que puedes llamar con una clave de API. Las claves, el uso y los presupuestos se gestionan desde el panel.

MétodoEndpointDescripción
POST/v1/chat/completionsChat completion (con y sin streaming)
POST/v1/messagesFormato Messages de Anthropic (con y sin streaming; x-api-key o Bearer)
POST/v1/responsesFormato 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/generationCoste y tokens de una petición, por su X-Wayjet-Request-Id (?id=)
POST/v1/embeddingsCrear embeddings
POST/v1/audio/speechTexto a voz (sale audio)
POST/v1/audio/transcriptionsVoz a texto (transcripción)
GET/v1/modelsListar 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.
Registro de cambios completo