Kimlik Doğrulama

API Anahtarları

Tüm TokenLab API istekleri bir API anahtarı gerektirir. OpenAI uyumlu endpoint’ler için bunu şu şekilde gönderin:

Authorization: Bearer sk-your-api-key

Anthropic uyumlu /v1/messages istekleri için şunu da kullanabilirsiniz:

x-api-key: sk-your-api-key

API Anahtarınızı Alma

TokenLab Dashboard hesabınıza giriş yapın
API Keys bölümünü açın
Yeni bir anahtar oluşturun
Buna açıklayıcı bir ad verin
Hemen kopyalayın çünkü yalnızca bir kez gösterilir

API anahtarlarını asla istemci tarafı kodunda açığa çıkarmayın
API anahtarlarını asla sürüm kontrolüne commit etmeyin
Ortam değişkenleri veya bir secret manager kullanın
Anahtarları periyodik olarak döndürün
Kullanılmayan anahtarları silin

API Anahtarlarını Kullanma

curl https://api.tokenlab.sh/v1/responses \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "Hello!"
  }'

import os
from openai import OpenAI

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

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.TOKENLAB_API_KEY,
  baseURL: 'https://api.tokenlab.sh/v1'
});

API Anahtarı Özellikleri

Kullanım Limitleri

Her API anahtarı için bir kullanım limiti ayarlayabilirsiniz:

Ayar	Açıklama
No Limit	Anahtar, hesabınızın bakiyesini kısıtlama olmadan kullanır
Fixed Limit	Anahtar, belirtilen tutara ulaştıktan sonra çalışmayı durdurur

Anahtar Öneki

Tüm TokenLab API anahtarları sk- ile başlar.

Anthropic Uyumluluğu

/v1/messages endpoint’i için Anthropic tarzı header beklendiği gibi çalışır:

curl https://api.tokenlab.sh/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

/v1/responses, /v1/chat/completions, /v1/models ve diğer TokenLab rotalarının çoğu gibi OpenAI uyumlu endpoint’ler için Authorization: Bearer ... kullanın.

Hata Yanıtları

Durum Kodu	Tür	Kod	Açıklama
401	`invalid_api_key`	`invalid_api_key`	Eksik veya geçersiz API anahtarı
401	`expired_api_key`	`expired_api_key`	API anahtarı iptal edildi
402	`insufficient_balance`	`insufficient_balance`	Hesap bakiyesi yetersiz
402	`quota_exceeded`	`quota_exceeded`	API anahtarı kullanım limitine ulaşıldı

Örnek:

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

Başlarken

Temel kılavuzlar

Medya kılavuzları

Kimlik Doğrulama

API Anahtarları

API Anahtarınızı Alma

API Anahtarlarını Kullanma

API Anahtarı Özellikleri

Kullanım Limitleri

Anahtar Öneki

Anthropic Uyumluluğu

Hata Yanıtları

​API Anahtarları

​API Anahtarınızı Alma

​API Anahtarlarını Kullanma

​API Anahtarı Özellikleri

​Kullanım Limitleri

​Anahtar Öneki

​Anthropic Uyumluluğu

​Hata Yanıtları

API Anahtarları

API Anahtarınızı Alma

API Anahtarlarını Kullanma

API Anahtarı Özellikleri

Kullanım Limitleri

Anahtar Öneki

Anthropic Uyumluluğu

Hata Yanıtları