API Dökümantasyonu

Hızlı Başlangıç

TamgaLabs, tamamen OpenAI uyumlu bir API gatewaydir. Tüm endpointler OpenAI formatını takip eder. Sadece base_url ve API anahtarınızı değiştirin.

curl https://tamgalabs.tr/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tamgalabs/gpt-5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Base URL: https://tamgalabs.tr/api/v1

Kimlik Doğrulama

Tüm API istekleri, Authorization headerında Bearer token olarak iletilen bir API anahtarı gerektirir.

Authorization: Bearer tl-sk-your-api-key-here

API anahtarlarınızı dashboarddan oluşturun.

Chat Completions

Mevcut AI modellerinden herhangi biriyle metin yanıtları oluşturun.

İstek Gövdesi

{
  "model": "tamgalabs/gpt-5",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "What is AI?"}
  ],
  "temperature": 0.7,
  "max_tokens": 1024,
  "top_p": 1,
  "stream": false
}

Parametreler

Streaming

Gerçek zamanlı SSE (Server-Sent Events) yanıtları için stream: true olarak ayarlayın. Her parça, oluşturulan içeriğin bir deltasını içerir.

curl https://tamgalabs.tr/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tamgalabs/gpt-5",
    "messages": [{"role": "user", "content": "Tell me a story"}],
    "stream": true
  }'

Akış data: [DONE] ile sona erer.

Modeller & Fiyatlandırma

250+ AI modeli mevcuttur. Tüm modellere aynı API endpointi üzerinden tutarlı fiyatlandırma ile erişilir. Tüm model kataloğunu Modeller sayfasında görüntüleyin.

GET /api/v1/models

Python SDK (OpenAI)

Resmi OpenAI Python kütüphanesini TamgaLabsı base URL olarak kullanın.

pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://tamgalabs.tr/api/v1",
    api_key="YOUR_API_KEY"
)

# Chat
response = client.chat.completions.create(
    model="tamgalabs/gpt-5",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

# Streaming
stream = client.chat.completions.create(
    model="tamgalabs/gpt-5",
    messages=[{"role": "user", "content": "Tell me a story"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

# Models list
models = client.models.list()
for m in models:
    print(m.id)

JavaScript / Node.js

const response = await fetch("https://tamgalabs.tr/api/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "tamgalabs/gpt-5",
    messages: [{role: "user", content: "Hello!"}],
    stream: false
  })
});
const data = await response.json();
console.log(data.choices[0].message.content);

cURL Örnekleri

# Chat
curl https://tamgalabs.tr/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tamgalabs/gpt-5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

# List models
curl https://tamgalabs.tr/api/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Kredi & Faturalama

TamgaLabs ön ödemeli kredi sistemi kullanır. İşleyiş şu şekildedir:

• Başlamak için hesabınıza para yatırın (minimum $5.00)
• Her API çağrısı, gerçek token kullanımı x model fiyatı üzerinden kredi bakiyenizden düşülür
• Kredi bakiyenizi Faturalama Dashboardında izleyebilirsiniz
• Bakiyeniz $0a ulaştığında API istekleri 402 Yetersiz Kredi döndürür
• Kredi yükleme Çok Yakında

Bakiyenizi API üzerinden kontrol edin:

curl https://tamgalabs.tr/api/dashboard/billing \
  -H "Cookie: tamgalabs_session=YOUR_SESSION"

Hız Limitleri

Hata Yönetimi