> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Göç Rehberleri

> OpenAI, Anthropic, Gemini ve medya iş yüklerini TokenLab'a küçük, üretim güvenli değişikliklerle taşıyın.

TokenLab çok formatlıdır: OpenAI uyumlu istemcileri, Anthropic yerel Messages çağrılarını, Gemini yerel REST çağrılarını ve medya uç noktalarını doğal şekillerinde tutabilirsiniz. En güvenli göç, her iş yükünü tek bir evrensel formata çevirmemektir. Uygulamanızın ihtiyaç duyduğu davranışı sahiplenen rotayı seçin.

## Rota Haritalama

| Mevcut iş yükü              | TokenLab temel URL'si        | Birincil uç nokta                       | Göç notu                                                                                 |
| --------------------------- | ---------------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------- |
| OpenAI Sohbet Tamamlamaları | `https://api.tokenlab.sh/v1` | `/chat/completions`                     | OpenAI uyumlu sohbet ve fonksiyon çağrıları için en küçük değişiklik                     |
| OpenAI Yanıtları            | `https://api.tokenlab.sh/v1` | `/responses`                            | Uygulamanız Yanıtlar'a özel girdi, araçlar veya çıktı işleme bağımlıysa kullanın         |
| Anthropic SDK               | `https://api.tokenlab.sh`    | `/v1/messages`                          | SDK temel URL'sine `/v1` eklemeyin                                                       |
| Gemini REST                 | `https://api.tokenlab.sh`    | `/v1beta/models/:model:generateContent` | Gemini rotasında Gemini yerel alanlarını koruyun                                         |
| Medya üretimi               | `https://api.tokenlab.sh/v1` | `/images`, `/videos`, `/music`, `/3d`   | `recommended_for` ile modelleri keşfedin ve belgelenmiş yerlerde asenkron anket bekleyin |
| Yönetim ve faturalama       | `https://api.tokenlab.sh/v1` | `/management/...`                       | Sunucu tarafı kullanımı ve faturalama uzlaştırması için yönetim token'larını kullanın    |

## OpenAI Uyumlu Göç

```python theme={null}
from openai import OpenAI

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

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Hello from TokenLab"}],
)
```

Mevcut yeniden deneme, zaman aşımı ve akış kodunuzu koruyun, ancak üretim trafiğinden önce model kimliklerini `GET /v1/models` ile doğrulayın. Görüntü üretimi için `model`'i açıkça gönderin ve görüntü kılavuzunu okuyun çünkü görüntü modelleri sohbet modellerinden daha fazla farklılık gösterir.

## Anthropic Göç

```python theme={null}
from anthropic import Anthropic

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

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain TokenLab in one sentence."}],
)
```

Claude yerel araç kullanımı, düşünme akışları ve Anthropic mesaj anlamları için `/v1/messages` kullanın. Anthropic'a özel alanları Sohbet Tamamlamaları aracılığıyla çevirmeyin, aksi takdirde OpenAI uyumlu bir davranış değişikliği istemiyorsanız.

## Gemini Göç

```bash theme={null}
curl "https://api.tokenlab.sh/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-your-tokenlab-key" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'
```

Uygulamanız Gemini yerel davranışa bağımlı olduğunda Gemini yerleşik araçlarını, Dosya API referanslarını, önbelleğe alınmış içerikleri, fonksiyon bildirimlerini ve yerel içerik parçalarını `/v1beta` üzerinde tutun.

## Medya Göçü

1. `GET /v1/models?recommended_for=image|video|music|3d` sorgulayın.
2. Liste yanıtlarında `tokenlab.public_contract_summary` ve mevcut olduğunda tam `tokenlab.public_contract`'ı okuyun.
3. Özellikle görüntü uç noktaları için açık bir `model` gönderin.
4. Asenkron işler için `task_id`, `poll_url`, uç nokta, model ve kendi iş ID'nizi saklayın.
5. Maliyetleri kullanım kayıtları ve `billing_transaction_id` aracılığıyla uzlaştırın, sağlayıcı görev kimliklerini kullanmayın.

Medya iş yükleri, gecikme, yeniden denemeler ve nihai varlıkların sohbet tamamlamalarından farklı davrandığı için kendi dağıtım planına ihtiyaç duyar.

## Üretim Dağıtım Planı

| Aşama                       | Hedef                                                                                                   | Kontroller                                                            |
| --------------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| 1. Envanter                 | Uç noktaları, modelleri, istek alanlarını, akış/asenkron davranışları ve faturalama sahibini listeleyin | Gizli sağlayıcıya özel alanların kamuya açık olduğu varsayılmamalıdır |
| 2. Tek rota pilotu          | Bir uç noktayı ve bir model ailesini taşıyın                                                            | Yanıt şekli, maliyet ve günlükler beklentilerle eşleşiyor             |
| 3. Gölgeleme veya örnekleme | Seçilen çıktıları önceki sağlayıcı ile karşılaştırın                                                    | Kullanıcı görünür kalitesi ve gecikmesi kabul edilebilir              |
| 4. Aşamalı dağıtım          | Trafiği anahtar, organizasyon veya özellik bayrağı ile artırın                                          | `4xx`, `5xx`, gecikme, denge ve yinelenen asenkron işleri izleyin     |
| 5. Temizlik                 | Eski sağlayıcı yolunu yalnızca kararlı kullanım sonrası kaldırın                                        | Geri alma yolu ve destek kılavuzu belgelenmiştir                      |

## Göç Tuzakları

* Uygulamanız yerel Anthropic, Gemini veya Yanıtlar davranışına ihtiyaç duyuyorsa her modeli tek bir OpenAI Sohbet Tamamlamaları yolunun arkasına koymayın.
* Eski görüntü varsayımlarını varsaymayın. `model`'i açıkça gönderin.
* Bir görev zaten oluşturulmuşsa asenkron oluşturma isteklerini yeniden denemeyin.
* Sağlayıcı yönlendirme meta verilerini günlüklerinizde veya kullanıcı arayüzünüzde açığa çıkarmayın.
* Faturalamayı sağlayıcı görev kimlikleri ile karşılaştırmayın. TokenLab kullanım kayıtlarını kullanın.

## API Referansı

| Konu                   | Referans                                                      |
| ---------------------- | ------------------------------------------------------------- |
| Çok Formatlı API       | [Çok Formatlı API](/tr/guides/api-formats)                    |
| OpenAI SDK             | [OpenAI SDK](/tr/integrations/openai-sdk)                     |
| Anthropic SDK          | [Anthropic SDK](/tr/integrations/anthropic-sdk)               |
| Gemini Yerel           | [Gemini Yerel API](/tr/api-reference/gemini/generate-content) |
| Görüntü Üretimi        | [Görüntü Üretimi](/tr/guides/image-generation)                |
| Asenkron İşler & Anket | [Asenkron İşler & Anket](/tr/guides/async-jobs-polling)       |