Guías principales

Formatos de API

Elija entre Chat Completions, Responses, Messages o Gemini

Una clave de API de TokenLab funciona con cuatro formatos de API comunes. Mantenga el formato que su aplicación ya utiliza a menos que necesite una función específica de un modelo.

FormatoEndpointElija este cuando
Chat Completions/v1/chat/completionsUtilice un cliente de chat compatible con OpenAI o desee una amplia compatibilidad de modelos
Responses/v1/responsesSu aplicación utilice eventos de Responses, respuestas en segundo plano o herramientas de Responses
Anthropic Messages/v1/messagesNecesite campos de Claude Messages como el razonamiento (thinking) o el uso de herramientas de Claude
Gemini/v1beta/models/:model:generateContentYa utilice contents, partes, archivos, caché o herramientas de Gemini

Consulte tokenlab.accepted_request_formats en la página del modelo o en GET /v1/models/{model}. Un modelo no acepta necesariamente los cuatro formatos.

Chat Completions

Chat Completions es la opción más sencilla para clientes existentes compatibles con OpenAI y funciones de chat portátiles.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-luna",
    messages=[{"role": "user", "content": "Hello!"}],
)

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

Utilice este formato para:

  • integraciones de chat existentes compatibles con OpenAI
  • historial de mensajes estándar y streaming
  • llamadas a funciones (function calling) compatibles con el modelo seleccionado

No se garantiza que los campos exclusivos de otro formato de API funcionen aquí.

Responses

Utilice Responses solo cuando el modelo seleccionado enumere openai_responses en accepted_request_formats.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh/v1",
)

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Explain why the sky is blue in two sentences.",
)

print(response.output_text)

La API de Responses admite la creación, recuperación, compactación, eliminación, streaming, creación y continuación de WebSocket, y respuestas en segundo plano cuando el modelo seleccionado los admite. La eliminación elimina una respuesta almacenada; no cancela una respuesta activa.

Anthropic Messages

Utilice el SDK de Anthropic con el host de TokenLab, sin añadir /v1 a la URL base.

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh",
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Hello!"}],
)

print(message.content[0].text)

Elija Messages para campos de solicitud y respuesta específicos de Claude. Mantenga las llamadas a herramientas de Claude, los bloques de razonamiento (thinking blocks) y los campos de caché de prompts en este formato.

Gemini

Las solicitudes de Gemini utilizan el host de TokenLab y la ruta REST de Gemini.

curl "https://api.tokenlab.sh/v1beta/models/gemini-3.6-flash:generateContent" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello!"}]}]
  }'

Elija Gemini cuando su aplicación ya utilice partes de contenido, declaraciones de funciones, archivos, contenido en caché u otros campos de Gemini. Se aceptan tanto los nombres en ProtoJSON lowerCamelCase como los nombres originales en proto snake_case; evite enviar ambas grafías del mismo campo en una misma solicitud.

No mezcle formatos en una misma conversación

Messages, Responses, Chat Completions y Gemini representan el estado de la conversación y las llamadas a herramientas de forma diferente. Mantenga un único formato por conversación. Si debe migrar un historial almacenado, conviértalo y valídelo en su aplicación antes de enviar la siguiente solicitud.

Campos desconocidos

TokenLab puede transmitir campos que no reconoce, pero eso no significa que todos los modelos los acepten. Solo es seguro depender de una función cuando el modelo seleccionado la documenta y su aplicación gestiona un error de campo no admitido.

Referencias relacionadas

En esta página