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.1 gibi 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-small ile 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_quota ile 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

OpenAI Platform – yeni secret key: ① Create new secret key, ② Service account, ③ Project: OrqLabs. (Temsili görsel)

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.

OpenAI – anahtar ve Organization ID: ① Secret key (sk-proj-…), ② Organization ID. (Temsili görsel)

① 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

OrqLabs bağlantı penceresi (OpenAI BYOK): ① API key, ② Organization ID, ③ organizasyon kapsamlı, ④ Bağla. (Temsili görsel)

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.

Bağlantı penceresi (anahtar): ① alan, ③ Bağla, ④ yan panelde kurulum rehberi.

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

Entegrasyon ayrıntı paneli: ① durum, ② Bağlantıyı test et, ⑤ Bağlantıyı kes.

② 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.

OpenAI API key (BYOK)

Kimlik kartı

Ne işe yarar?

Ön koşullar