OpenAI SDK

Ringkasan

TokenLab bekerja dengan SDK resmi OpenAI dengan mengarahkan klien ke https://api.tokenlab.sh/v1. Untuk sebagian besar proyek baru, lebih baik menggunakan Chat Completions sebagai jalur default yang kompatibel dengan OpenAI. Gunakan Responses API hanya ketika Anda secara eksplisit membutuhkan perilaku khusus Responses. Field khusus Responses tidak dijamin berperilaku identik di setiap model dan jalur yang dirutekan.

Python, JavaScript, dan Go memiliki SDK resmi OpenAI. PHP bekerja dengan baik dengan klien komunitas yang kompatibel dengan OpenAI, namun itu bukan SDK resmi OpenAI.

Tipe: Native SDKJalur Utama: kompatibel OpenAI / Chat CompletionsTingkat Dukungan: Jalur inti didukung

Instalasi

pip install openai

npm install openai

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

Gunakan POST /v1/responses hanya ketika Anda secara eksplisit membutuhkan perilaku khusus Responses. Beberapa field yang hanya untuk Responses masih dapat bergantung pada model yang dipilih dan jalur yang dirutekan.

Konfigurasikan Klien

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
}

Rekomendasi: 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."}
    ]
  }'

Lanjutan: Responses API

Gunakan jalur ini hanya ketika alat atau alur kerja Anda secara eksplisit bergantung pada semantik OpenAI Responses.

Streaming dengan 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);
  }
}

Alat / Pemanggilan fungsi

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)

Vision dengan 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 adalah jalur default yang kompatibel dengan OpenAI untuk 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)

Pemecahan Masalah

Kesalahan Koneksi

Pastikan base URL persis https://api.tokenlab.sh/v1
Periksa gangguan proxy atau penggantian klien HTTP kustom
Pastikan versi SDK Anda terbaru sebelum men-debug perilaku provider

Autentikasi Gagal

Periksa bahwa API key Anda diawali dengan sk-
Verifikasi bahwa kunci aktif di dashboard TokenLab
Konfirmasi SDK mengirim Authorization: Bearer ...

Jalur API Salah

responses.create(...) mengirim permintaan ke /v1/responses
chat.completions.create(...) mengirim permintaan ke /v1/chat/completions
Gunakan Chat Completions secara default kecuali Anda secara eksplisit membutuhkan perilaku khusus Responses

Matriks kompatibilitas

Alat coding

SDK native

Framework & platform

Aplikasi chat

Ringkasan

Instalasi

Konfigurasikan Klien

Rekomendasi: Chat Completions

Lanjutan: Responses API

Streaming dengan Responses

Alat / Pemanggilan fungsi

Vision dengan Responses

Embeddings

Chat Completions

Pemecahan Masalah

​Ringkasan

​Instalasi

​Konfigurasikan Klien

​Rekomendasi: Chat Completions

​Lanjutan: Responses API

​Streaming dengan Responses

​Alat / Pemanggilan fungsi

​Vision dengan Responses

​Embeddings

​Chat Completions

​Pemecahan Masalah

Ringkasan

Instalasi

Konfigurasikan Klien

Rekomendasi: Chat Completions

Lanjutan: Responses API

Streaming dengan Responses

Alat / Pemanggilan fungsi

Vision dengan Responses

Embeddings

Chat Completions

Pemecahan Masalah