Inicio rápido
Empieza con Synthorai en menos de 2 minutos.
1. Obtén tu clave API
Inicia sesión y ve a Consola → Claves API. Haz clic en «Crear clave» y cópiala de inmediato — solo se mostrará una vez.
2. Haz tu primera solicitud
Elige el SDK que ya usas. Ambas recetas llaman al mismo gateway con la misma clave API.
Opción A — SDK de OpenAI
curl https://synthorai.io/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "gpt-5.4-mini",
"messages": [
{"role": "user", "content": "Hello! What can you do?"}
]
}'from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://synthorai.io/v1"
)
response = client.chat.completions.create(
model="gpt-5.4-mini",
messages=[{"role": "user", "content": "Hello! What can you do?"}]
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: "YOUR_API_KEY",
baseURL: "https://synthorai.io/v1",
});
const response = await client.chat.completions.create({
model: "gpt-5.4-mini",
messages: [{ role: "user", content: "Hello! What can you do?" }],
});
console.log(response.choices[0].message.content);Opción B — SDK de Anthropic
curl https://synthorai.io/v1/messages \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 256,
"messages": [
{"role": "user", "content": "Hello! What can you do?"}
]
}'from anthropic import Anthropic
client = Anthropic(
api_key="YOUR_API_KEY",
base_url="https://synthorai.io"
)
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=256,
messages=[{"role": "user", "content": "Hello! What can you do?"}]
)
print(message.content[0].text)import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: "YOUR_API_KEY",
baseURL: "https://synthorai.io",
});
const message = await client.messages.create({
model: "claude-sonnet-4-6",
max_tokens: 256,
messages: [{ role: "user", content: "Hello! What can you do?" }],
});
console.log(message.content[0].text);El SDK de Anthropic añade /v1/messages internamente. Use el origen de la pasarela (sin /v1 como sufijo) base_url — a diferencia del SDK de OpenAI, que toma https://synthorai.io/v1.
3. Lista los modelos disponibles
curl https://synthorai.io/v1/models \
-H "Authorization: Bearer YOUR_API_KEY" Los ID de modelo siguen el formato del proveedor original. Puedes ver la lista completa con el endpoint /v1/models o visita la página Catálogo de modelos .
¿Usas una herramienta en lugar de un SDK directo?
Si conectas Synthorai a Claude Code, OpenAI Codex CLI, OpenClaw, Cursor, Continue, Aider o cualquier otra herramienta compatible con OpenAI/Anthropic — hay una página de configuración dedicada para cada uno de los tres principales, además de una hoja de referencia de base-URL para todo lo demás.
Autenticación
Todas las solicitudes de la API requieren una clave API pasada en el Authorization encabezado.
Token Bearer
Authorization: Bearer YOUR_API_KEY Ámbitos de la clave
| Parámetro | Tipo | Descripción |
|---|---|---|
Read | string | Acceso solo a la lista de modelos y los datos de uso. |
Write | string | Realizar solicitudes de inferencia (chat, completions). |
Admin | string | Acceso completo, incluida la gestión de canales y usuarios. |
Nunca expongas tu clave API en código del lado del cliente ni en repositorios públicos. Rota las claves de inmediato si se ven comprometidas mediante Consola → Claves API.
Formato de la clave
Las claves de Synthorai llevan el prefijo sk- seguido de una cadena aleatoria de 32 caracteres. Las claves se cifran (hash) en reposo y no se pueden recuperar después de su creación.
¿No sabes con qué modelo empezar? Explora la model price comparison para ver el precio por token de cada modelo enrutable en paralelo.