Bu rehberde: GPT modellerini, görsel üretimini ve bilgi bankası aramasını kendi OpenAI hesabınızla çalıştırırsınız. Yalnızca Claude kullansanız bile bilgi bankası için bir OpenAI anahtarı gerektiğini öğrenirsiniz.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | OPENAI |
| Kategori | LLM anahtarları (BYOK) |
| Kimlik doğrulama | API anahtarı (+ isteğe bağlı Organization ID) |
| Kapsam | Organizasyon geneli |
| Webhook | Hayır |
| Yetenekler | LLM |
| Kullanan kutular | GPT seçilen ajan ve yapay zekâ kutuları; Görsel üret; Bilgi bankası ara ve belge indeksleme |
| Kullanan ajanlar | GPT modeli seçilen her ajan; bilgi bankası kullanan tüm ajanlar (dolaylı) |
Ne işe yarar?
Bu anahtardan üç işlev geçer:
- GPT modelleri: ajan ve yapay zekâ kutularında
gpt-5,gpt-5-mini,gpt-4.1gibi bir model seçildiğinde. - Görsel üretimi: Görsel üret kutusu OpenAI Images ile çalışır; Claude görsel üretmez.
- Bilgi bankası gömmeleri: belgeler
text-embedding-3-smallile indekslenir; arama sorguları da aynı modelle gömülür.
Dikkat: Ajanlarınız yalnızca Claude kullansa bile bilgi bankası için bir OpenAI anahtarı (platform veya sizin) gereklidir.
Anahtar tanımlı değilse platform anahtarı kullanılır ve harcama aylık LLM bütçenize sayılır. Kendi anahtarınızla yapılan çağrılar da kullanım sayfasında görünür, ama faturayı OpenAI size keser ve bu harcama bütçenize ya da platform harcama tavanlarına sayılmaz; üst sınırı OpenAI hesabınızda (Settings → Limits) koyun.
Ön koşullar
- Planınız STARTER veya üstü. BYOK plan katmanlarını genişletmez.
- OpenAI Platform hesabı, ödeme yöntemi ve pozitif bakiye. Kredisiz hesaplarda ilk çağrı
insufficient_quotaile reddedilir. - OpenAI'de Owner rolü veya anahtar oluşturma izni.
- OrqLabs'ta Sahip veya Yönetici rolü.
- Görsel modelleri için bazı hesaplarda organizasyon doğrulaması.
Adım adım kurulum
A) OpenAI Platform
- platform.openai.com → doğru organizasyonu seçin.
- Settings → Organization → Billing: ödeme yöntemi ve bakiye. Auto recharge önerilir.
- (Önerilen) Settings → Organization → Projects → Create →
OrqLabs. Proje Limits sekmesinden bütçe ve model erişimi. - ① API keys → Create new secret key: ② Owned by: Service account (kişi ayrılsa da çalışır); Name; ③ Project:
OrqLabs; Permissions: All veya Restricted (Model capabilities: Write zorunlu) → Create secret key.
- ① Anahtar
sk-proj-…biçiminde yalnızca bir kez gösterilir; kopyalayın. - ② Organization ID (
org-…, Settings → Organization → General): proje anahtarlarında genellikle boş bırakılır; yalnızca birden fazla organizasyona üye eski tip anahtarlarda gerekir.
B) OrqLabs'ta bağlama
- Entegrasyonlar → OpenAI API key (BYOK) → Bağla. ③ Organizasyon geneli.
- Alanlar:
| Alan | Nereden alınır |
|---|---|
| API key ① | API keys → Create new secret key |
| Organization ID (optional) ② | Settings → Organization → General; genellikle boş |
- ④ Bağla. OrqLabs küçük bir deneme isteğiyle doğrular. Bu andan itibaren GPT çağrıları, görsel üretimi ve yeni belge indekslemeleri bu anahtarla yapılır.
Kullanılabilen modeller
| Model | Katman | Giriş $/1M | Çıkış $/1M | Bağlam | Not |
|---|---|---|---|---|---|
gpt-5 | amiral gemisi | 1.25 | 10 | 400K | Düşünme derinliği çalışır |
gpt-5-mini | dengeli | 0.25 | 2 | 400K | Chatbot, taslak içerik |
gpt-5-nano | ekonomi | 0.05 | 0.4 | 400K | Sınıflandırma |
gpt-4.1 | dengeli | 2 | 8 | 1M | Uzun bağlam |
gpt-4.1-mini | ekonomi | 0.4 | 1.6 | 1M | Chatbot, sınıflandırma |
gpt-4o | dengeli | 2.5 | 10 | 128K | Görsel anlama |
o3 | amiral gemisi | 2 | 8 | 200K | Varsayılan kapalı |
o4-mini | ekonomi | 1.1 | 4.4 | 200K | Varsayılan kapalı |
Düşünen modeller (gpt-5*, o3, o4-mini) sıcaklık parametresi almaz; OrqLabs göndermez.
Gömme modelleri
| Model | Boyut | Fiyat $/1M |
|---|---|---|
text-embedding-3-small (varsayılan) | 1536 | 0.02 |
text-embedding-3-large | 3072 | 0.13 |
Gömme modeli platform genelinde EMBEDDING_MODEL_ID ile belirlenir. Değişirse tüm bilgi bankası belgeleri yeniden indekslenmelidir.
Görsel üretimi
Görsel üret kutusu Prompt ve Size (1024x1024, 1024x1536, 1536x1024) ile çalışır. Ücret görsel başınadır ve token ölçümüne girmez; OpenAI Usage panosunu izleyin.
İzinler
| Kontrol | Nerede | Gereken |
|---|---|---|
| Anahtar izni | API keys → Permissions | All veya Restricted + Model capabilities: Write |
| Proje kapsamı | Anahtar oluşturulurken | Anahtar o projenin bütçe ve limitlerine tabi |
| Proje bütçesi | Projects → Limits → Budget | Aşımda red |
| Model erişimi | Projects → Limits → Model access | Kullanılacak modeller "allowed" |
Kullanım katmanları
OpenAI uygulama incelemesi yapmaz; bazı modeller için Verifications altında kimlik doğrulaması ister. Tier 1'den Tier 5'e harcamaya göre otomatik yükselir. Paralel ajanlar için Tier 2+ önerilir.
Bağlantıyı test etme
② Bağlantıyı test et gpt-5-nano ile küçük bir istek ve tek satırlık bir gömme isteği gönderir. Böylece Claude kullansanız bile bilgi bankası indekslemesinin çalışacağı doğrulanır. Maliyet 0,001 $'ın altındadır.
Kimlik bilgilerini yenileme
- Anahtarlar süresizdir.
- Yenileme: yeni anahtar (aynı proje ve izinlerle) → entegrasyon kartı → Kimlik bilgileri → Güncelle → API key → test → eski anahtarı silin.
- Owned by: You anahtarları kişi organizasyondan çıkarılınca geçersiz olur; Service account kullanın.
- Sızıntıda önce OpenAI'de silin; yeni anahtar girilene kadar çağrılar platform anahtarına düşmez.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401 invalid_api_key | Anahtar yanlış | Yeni anahtar |
AUTH – 401 "No such organization" | Organization ID yanlış | Alanı boşaltın veya birebir girin |
AUTH – 403 insufficient_permissions | Restricted anahtarda izin yok | All veya Model capabilities: Write |
AUTH – 403 "organization must be verified" | Görsel modeli doğrulama ister | Verifications |
INVALID – 404 model_not_found | Proje model erişimi kısıtlı | Projects → Limits → Model access |
RATE_LIMIT – 429 rate_limit_exceeded | RPM/TPM aşıldı | Otomatik tekrar; katman yükseltin |
RATE_LIMIT – 429 insufficient_quota | Bakiye sıfır | Bakiye yükleyin; tekrar denemek işe yaramaz |
INVALID – 400 context_length_exceeded | Bağlam aşıldı | Parça sayısı ve adımı düşürün |
INVALID – content_policy_violation (görsel) | Prompt politikaya takıldı | Görsel açıklamasını yumuşatın |
| Belge "indexing failed" | OpenAI anahtarı yok | Bu entegrasyonu bağlayın |
Sık sorulan sorular
Yalnızca Claude kullanıyorum; bu anahtar şart mı? Bilgi bankası ve görsel üretimi kullanıyorsanız evet, bir OpenAI anahtarı (platform veya sizin) gerekir.
Görsel üretimi ne kadar tutar? Görsel başına ücretlendirilir; OpenAI fiyat listesine ve Usage panosuna bakın.