Inicio Rápido

URLs base de la API

TokSpan habla varios protocolos de API. Elige el que tu SDK ya usa — todos los formatos aceptan la misma clave API y acceden a más de 200 modelos.

Compatible con OpenAI

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokspan.com/v1",  # ← OpenAI-compatible base URL
)

response = client.chat.completions.create(
    model="MODEL_NAME",  # Replace MODEL_NAME with any model from the catalog
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

Nativo de Anthropic

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-api-key",
    base_url="https://api.tokspan.com",  # ← Native Anthropic base URL (host root; SDK appends /v1/messages)
)

response = client.messages.create(
    model="MODEL_NAME",  # Replace MODEL_NAME with any Claude model from the catalog
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.content[0].text)

Compatible con Gemini

from google import genai

client = genai.Client(
    api_key="sk-your-api-key",
    http_options=genai.types.HttpOptions(
        base_url="https://api.tokspan.com/v1beta",  # ← Gemini base URL
    ),
)

response = client.models.generate_content(
    model="MODEL_NAME",  # Replace MODEL_NAME with any Gemini model from the catalog
    contents="Hello!",
)

print(response.text)

Responses API

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokspan.com/v1",  # ← Same base URL as OpenAI-compatible
)

response = client.responses.create(
    model="MODEL_NAME",  # Replace MODEL_NAME with any model from the catalog
    input="Hello!",
)

print(response.output_text)

Uso de la API de TokSpan

Sin SDK — envía solicitudes directamente al endpoint compatible con OpenAI con HTTP puro:

Todas las solicitudes usan el mismo formato: POST https://api.tokspan.com/v1/chat/completions con tu clave API en el encabezado Authorization.

import requests

def chat(prompt: str, model: str = "MODEL_NAME"):  # Replace MODEL_NAME with any model from the catalog
    response = requests.post(
        "https://api.tokspan.com/v1/chat/completions",
        headers={
            "Authorization": "Bearer sk-your-api-key",
            "Content-Type": "application/json",
        },
        json={
            "model": model,
            "messages": [{"role": "user", "content": prompt}],
        },
    )
    return response.json()["choices"][0]["message"]["content"]

print(chat("Hello! What models are available?"))

const chat = async (prompt: string, model = 'MODEL_NAME') => {  // Replace MODEL_NAME with any model from the catalog
  const res = await fetch('https://api.tokspan.com/v1/chat/completions', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk-your-api-key',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model,
      messages: [{ role: 'user', content: prompt }],
    }),
  });
  const data = await res.json();
  return data.choices[0].message.content;
};

curl -X POST "https://api.tokspan.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Conversión entre formatos

TokSpan convierte automáticamente entre diferentes formatos de API de forma transparente. Tú siempre envía solicitudes en el formato OpenAI Chat Completions: TokSpan se encarga de la traducción al formato nativo del proveedor upstream:

• OpenAI → Claude Messages API: los prompts de sistema, la conversación de múltiples turnos y las definiciones de herramientas se reasignan automáticamente
• OpenAI → Gemini API: las partes de contenido, la configuración de seguridad y los parámetros de generación se traducen de forma transparente
• Claude → formato OpenAI: las respuestas nativas de Claude se normalizan a la estructura estándar de respuesta de Chat Completions

Esto significa que puedes usar el SDK de OpenAI para Python/Node, LangChain o cualquier biblioteca compatible con OpenAI para llamar a cualquier modelo, independientemente de tu formato de API nativo.

Alcance y permisos de claves

Cada clave API puede tener un alcance limitado a permisos específicos:

• Modelos: Restringe a qué modelos puede acceder la clave
• Límite de gasto: Establece un límite de cuota fijo; la clave se desactiva automáticamente cuando se agota su cuota
• Lista blanca de IP: Solo permite solicitudes desde rangos de IP específicos

¿Qué sigue?

• Explore el catálogo completo de modelos: más de 200 modelos en más de 50 proveedores
• Conozca el failover automático para resiliencia en producción
• Descubra las integraciones de SDK para Python, JavaScript y más
• Lea la referencia de la API de Chat Completions con todos los parámetros