Başlarken
Bu sayfada
Bu kılavuz, bir tesisi üç adımda sıfırdan çalışan ilk isteğe taşır ve ardından işlemin başarılı olup olmadığını nasıl kontrol edeceğinizi gösterir.
Başlamadan önce
- Organisation Administrator olmanız gerekir. Model Router, Technology Stack tesislerinde yalnızca Organisation Administrator kullanıcıları tarafından kullanılabilir.
- Ana Performance Hub araç çubuğundaki tesis seçiciyi kullanarak yapılandırmak istediğiniz tesisi seçin.
- Tesis için kayıtlı bir fatura kartınız olsun veya bir kart eklemeye hazır olun. Bakiye yüklemeleri kayıtlı fatura kartınızdan tahsil edilir; kayıtlı kart yoksa Balance & Top-up sayfasında Add payment details bağlantısıyla birlikte "No card on file." gösterilir.
1. adım: Model Router'ı etkinleştirin
Ana menüden (AI Modules & Agents grubunda) Model Router'ı açın. Modül bu tesis için henüz etkinleştirilmemişse Welcome to Model Router sayfasını görürsünüz:
"Tek bir OpenAI uyumlu uç nokta (endpoint) üzerinden işletmenize önde gelen yapay zeka modelleri kataloğuna ön ödemeli erişim sağlayın. Performance Hub AI Agents otomatik olarak bağlanır ve harcama limitleri ile tam kullanım görünürlüğü eşliğinde aynı modelleri kendi yazılımınıza entegre etmek için API anahtarları oluşturabilirsiniz."
Şekil 1: Modül etkinleştirilmeden önce bir tesisin gördüğü Welcome to Model Router sayfası
Sayfada üç düğme bulunur: Enable Model Router, Read the documentation (bu belgeleri açar) ve Explore first without enabling. Bunların altında üç adım kurulumu açıklar:
| Adım | Ne söyler | Düğme |
|---|---|---|
| 1. Enable & add a billing card | "Turn on prepaid AI inference for this facility and store a billing card if you have not already — nothing is charged until you top up." | Enable module |
| 2. Top up your balance | "Add prepaid credit with your stored billing card (minimum $10). Turn on auto top-up so inference never stops because the balance ran out." | Top up |
| 3. Connect an agent or create an API key | "Paired AI Agent devices connect automatically. For your own software, create an API key and point any OpenAI-compatible SDK at our endpoint." | Create an API key |
Her adımda ayrıca bir Learn more bağlantısı bulunur.
Modülü açmak için Enable Model Router (veya Enable module) düğmesine tıklayın.
Kurulum kontrol listesi
Modülü etkinleştirdikten sonra, kurulum tamamlanana kadar Model Router'ın üst kısmında bir kurulum kontrol listesi başlığı gösterilir. Başlığı Finish setting up Model Router olan bu alan, tahmini bir süre (ör. ~3 min left), kaç adımın tamamlandığını (ör. 2 of 3 complete) ve kontrol listesinin tamamını genişleten bir Resume düğmesini gösterir. Her adımda Review (veya Review again) ve Learn more bulunur; Collapse listeyi yeniden daraltır. Tek bir adım kaldığında genişletilmiş alt başlıkta "Just one step to go before AI requests start flowing. Steps can be done in any order." yazar.
Şekil 2: Kurulum tamamlanana kadar gösterilen kurulum kontrol listesi başlığı
Zorunlu adımlar Add a billing card, Top up your balance ve Connect an agent or create an API key adımlarıdır. İsteğe bağlı adımlar (Set spend limits, Turn on auto top-up ve Verify your first request) Skip for now ile kapatılabilir.
2. adım: İlk bakiye yüklemenizi yapın
Budgets & Limits → Balance & Top-up bölümüne gidin.
Şekil 3: Top up balance kartı (hazır tutarlar, tutar, kayıtlı kart) ve Auto top-up kartı
- Top up balance kartında hazır bir tutar seçin ($25, $50, $100, $250, $500, $1000) veya bir tutar yazın. "Minimum top-up is $10."
- Tutarın altında gösterilen kayıtlı kartı kontrol edin (ör. "Amex ending 0005 · exp 06/29"). Güncellenmesi gerekiyorsa Edit payment details seçeneğini kullanın.
- Top up $–.–– düğmesine tıklayın. İşlem başarılı olduğunda "Top-up successful. Your balance has been credited." mesajını görürsünüz. Bakiye yüklemeleri bakiyeye anında yansır.
Önerilir: Auto top-up kartında Enable auto top-up seçeneğini açın, When balance is below ve Top up by (en az $10) değerlerini ayarlayın ve Save changes düğmesine tıklayın. Böylece bakiye eşiğin altına düştüğünde kartınızdan otomatik olarak tahsilat yapılır ve çıkarım hiçbir zaman beklenmedik şekilde durmaz. Ayrıntılar için bkz. Bütçeler ve bakiye yüklemeleri.
3. adım: İlk isteğinizi gönderin
Size uygun yolu seçin:
AI Agents veya Workflows kullanıyorsanız
Yapılandırılacak bir şey yok: bu tesisle eşleştirilmiş AI Agent cihazları otomatik olarak bağlanır, Workflows da bağlanabilir. Settings (dişli) → Service Access & API Keys bölümünü açın ve ajanınızın Connected Services altında Çevrimiçi durumuyla göründüğünü doğrulayın. Bkz. Connected Services.
Kendi yazılımınızı bağlıyorsanız
- Settings (dişli) → Service Access & API Keys bölümünü açın ve Create key düğmesine tıklayın. Gizli anahtarı "Copy your API key" iletişim kutusundan kopyalayın: "This is the only time the full key is shown. Store it somewhere safe."
- Aynı sayfadaki Connecting to the API kartında gösterilen Base URL ve örnek isteği kullanın. Basit bir test:
curl https://app.performancehub.co/ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "messages": [{"role": "user", "content": "Hello"}]}'
Python ve TypeScript örnekleri için bkz. Uygulamanızı bağlama.
4. adım: Doğrulayın
Logs sekmesini açın. Test isteğiniz birkaç saniye içinde modeli, token sayıları, maliyeti, hızı ve success durumuyla birlikte görünmelidir. Görünmezse bkz. Sorun giderme.
Önerilen sonraki adımlar
- Harcama sınırları belirleyin: Budgets & Limits → Spend Limits. Aylık bir üst sınır makul bir güvenlik önlemidir; bkz. Bütçeler ve bakiye yüklemeleri.
- Model kataloğunu gözden geçirin: Settings → Models. Tüm modeller varsayılan olarak etkindir; sağlayıcı veya bütçe tercihleriniz varsa kümeyi daraltmak için hızlı ön ayarları kullanın. Bkz. Models.
- Guardrail'leri değerlendirin: kişisel verileri maskeleme, gizli bilgileri karartma ve istem enjeksiyonuna karşı koruma için Settings → Guardrails. Hiçbiri varsayılan olarak etkin değildir. Bkz. Guardrails.