SDK de OpenAI

Resumen

TokenLab funciona con los SDK oficiales de OpenAI apuntando el cliente a https://api.tokenlab.sh/v1. Para la mayoría de proyectos nuevos, prefiera Chat Completions como la ruta compatible con OpenAI predeterminada. Use Responses API solo cuando necesite explícitamente el comportamiento específico de Responses. Los campos específicos de Responses no garantizan comportarse de forma idéntica en todos los modelos y rutas dirigidas.

Python, JavaScript y Go tienen SDKs oficiales de OpenAI. PHP funciona bien con clientes comunitarios compatibles con OpenAI, pero no es un SDK oficial de OpenAI.

Tipo: SDK nativoRuta primaria: compatible con OpenAI / Chat CompletionsNivel de soporte: Ruta principal soportada

Instalación

pip install openai

npm install openai

go get github.com/openai/openai-go/v3

Utilice POST /v1/responses solo cuando necesite explícitamente comportamiento específico de Responses. Algunos campos exclusivos de Responses aún pueden depender del modelo seleccionado y de la ruta enrutada.

Configurar el cliente

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-tokenlab-key",
    base_url="https://api.tokenlab.sh/v1",
)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-tokenlab-key',
  baseURL: 'https://api.tokenlab.sh/v1',
});

package main

import (
    openai "github.com/openai/openai-go/v3"
    "github.com/openai/openai-go/v3/option"
)

func main() {
    client := openai.NewClient(
        option.WithAPIKey("sk-your-tokenlab-key"),
        option.WithBaseURL("https://api.tokenlab.sh/v1"),
    )

    _ = client
}

Recomendado: Chat Completions

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Explain what TokenLab does in one sentence."}]
)

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

const response = await client.chat.completions.create({
  model: 'gpt-5.4',
  messages: [{ role: 'user', content: 'Explain what TokenLab does in one sentence.' }],
});

console.log(response.choices[0].message.content);

curl https://api.tokenlab.sh/v1/chat/completions \
  -H "Authorization: Bearer sk-your-tokenlab-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "Explain what TokenLab does in one sentence."}
    ]
  }'

Avanzado: Responses API

Usa esta ruta solo cuando tu herramienta o flujo de trabajo dependa explícitamente de la semántica de OpenAI Responses.

Streaming con Responses

stream = client.responses.create(
    model="gpt-5.4",
    input="Write a short poem about coding.",
    stream=True,
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="")

const stream = await client.responses.create({
  model: 'gpt-5.4',
  input: 'Write a short poem about coding.',
  stream: true,
});

for await (const event of stream) {
  if (event.type === 'response.output_text.delta') {
    process.stdout.write(event.delta);
  }
}

Herramientas / Llamado de funciones

response = client.responses.create(
    model="gpt-5.4",
    input="What's the weather in Tokyo?",
    tools=[{
        "type": "function",
        "name": "get_weather",
        "description": "Get weather for a location",
        "parameters": {
            "type": "object",
            "properties": {
                "location": {"type": "string"}
            },
            "required": ["location"]
        }
    }]
)

for item in response.output:
    if item.type == "function_call":
        print(item.name)
        print(item.arguments)

Visión con Responses

response = client.responses.create(
    model="gpt-4o",
    input=[{
        "role": "user",
        "content": [
            {"type": "input_text", "text": "What's in this image?"},
            {"type": "input_image", "image_url": "https://example.com/image.jpg"}
        ]
    }]
)

print(response.output_text)

Embeddings

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="Hello world"
)

print(response.data[0].embedding[:5])

Chat Completions

Chat Completions es la ruta compatible con OpenAI predeterminada para TokenLab:

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

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

Solución de problemas

Error de conexión

Verifique que la URL base sea exactamente https://api.tokenlab.sh/v1
Compruebe si hay interferencia de un proxy o anulaciones personalizadas del cliente HTTP
Asegúrese de que la versión de su SDK esté actual antes de depurar el comportamiento del proveedor

Autenticación fallida

Verifique que su API key comience con sk-
Confirme que la clave esté activa en el panel de TokenLab
Confirme que el SDK esté enviando Authorization: Bearer ...

Ruta API incorrecta

responses.create(...) envía solicitudes a /v1/responses
chat.completions.create(...) envía solicitudes a /v1/chat/completions
Use Chat Completions por defecto a menos que necesite explícitamente el comportamiento específico de Responses

Matriz de compatibilidad

Herramientas de código

SDKs nativos

Frameworks y plataformas

Apps de chat

Resumen

Instalación

Configurar el cliente

Recomendado: Chat Completions

Avanzado: Responses API

Streaming con Responses

Herramientas / Llamado de funciones

Visión con Responses

Embeddings

Chat Completions

Solución de problemas

​Resumen

​Instalación

​Configurar el cliente

​Recomendado: Chat Completions

​Avanzado: Responses API

​Streaming con Responses

​Herramientas / Llamado de funciones

​Visión con Responses

​Embeddings

​Chat Completions

​Solución de problemas

Resumen

Instalación

Configurar el cliente

Recomendado: Chat Completions

Avanzado: Responses API

Streaming con Responses

Herramientas / Llamado de funciones

Visión con Responses

Embeddings

Chat Completions

Solución de problemas