API referansı
apikey.sh OpenAI protokolünü konuşur. OpenAI ile çalışan her SDK, framework veya araç, base_url değiştirildikten sonra burada da çalışır.Hızlı başlangıç
Panelde bir key oluşturun, ortam değişkenine koyun, ardından base URL'i yönlendirin:from openai import OpenAI
client = OpenAI(
api_key="sk-ak-...", # your key from apikey.sh
base_url="https://apikey.sh/v1", # change only this line
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)Base URL
Aynı API key aşağıdaki tüm domainlerde çalışır — hangisini isterseniz seçin.Anthropic SDK, base URL'i /v1 olmadan kullanır (örneğin https://apikey.sh).
https://apikey.sh/v1yayındahttps://api.onie.net/v1yayındaKimlik doğrulama
Key'inizi bir header ile gönderin:
Authorization: Bearer sk-ak-... # or, with the Anthropic SDK: x-api-key: sk-ak-...Key yalnızca oluşturulurken bir kez gösterilir. Kaybederseniz yenisini oluşturup eskisini iptal edin — iptal anında geçerli olur.
Endpointler
| POST | /v1/chat/completions | Completion üretir (SSE streaming ve tool calling destekler) |
| POST | /v1/embeddings | RAG ve semantik arama için embedding oluşturur |
| POST | /v1/images/generations | Görsel üretir (gpt-image-* modelleri) |
| GET | /v1/models | Mevcut key'in erişebildiği modelleri listeler |
Streaming
Tokenları SSE üzerinden gerçek zamanlı almak için stream: true ekleyin:
stream = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Write a short poem"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")Prompt caching
Desteklenen modellerde (GPT-5.x serisi), prompt'unuzun tekrar eden öneki otomatik olarak cache'lenir ve cache fiyatından faturalanır — yeni tokenlardan yaklaşık %90 daha ucuz. Kodunuzda değiştirilecek bir şey yok; cache'lenen token sayılarını panelde Kullanım bölümünde görebilirsiniz.Yanıtlar usage.prompt_tokens_details.cached_tokens alanını içerir, böylece kendiniz de doğrulayabilirsiniz.
Key başına limitler
Her key kendi harcama limitini ve izinli model listesini taşıyabilir. Key'leri projeler veya ekip arkadaşları arasında, biri bütçeyi tüketme riski olmadan paylaşmanın güvenli yolu budur. Panel → API keys bölümünden ayarlayın.
Hata kodları
401 | Geçersiz key, iptal edilmiş key veya askıya alınmış hesap |
402 | Kredi bitti — panelden yükleme yapın |
403 | Model bu key'in izin listesinde değil |
429 | Key rate limit aşıldı |
5xx | Upstream sağlayıcı hatası — birkaç saniye sonra tekrar deneyin |