Resmî OpenAI kimlik doğrulamasıyla Astra API kurulumu

Sağlayıcı ve faturalandırma hesabıyla başlayın

gpt-6-astra'yı kendi OpenAI Platform anahtarınızla OpenAI API üzerinden kullanın. Bir uygulama için aşağıdaki Responses örneğiyle başlayın. Yerel kodlama çalışması için Codex CLI giriş ve model seçme komutlarını kullanın. Her iki yol da Platform hesabınızı kullanır ve geçerli OpenAI oranlarına göre API ücreti doğurur.

Bir istek çalıştırmadan önce Platform projesinin sahibini, anahtarın modele erişip erişemediğini ve hangi faturalandırma denetimlerinin geçerli olduğunu doğrulayın. ChatGPT veya Codex'te görünen bir model her API projesine erişim vermez. Abonelik girişi ile API anahtarı girişini çalışma notlarınızda ayrı tutun. Daha sonra bir sınırı teşhis ederken veya ücretleri uzlaştırırken bu ayrım kritik olacaktır.

Anahtarı ve istemciyi güvenilir bir ortamda hazırlayın

OpenAI kontrol panelinde bir API anahtarı oluşturun ve özel ortamınız veya gizli bilgi yöneticiniz üzerinden OPENAI_API_KEY olarak sağlayın. Resmî SDK bu değişkeni okur. Anahtarı tarayıcı JavaScript'ine, herkese açık bir depoya, ekran görüntüsüne veya paylaşılan terminal kaydına asla gömmeyin. Kimlik bilgileriyle çalışırken shell tracing kullanmaktan kaçının.

Aşağıdaki JavaScript örneği için resmî openai paketini projenize npm install openai ile kurun. Kurulu sürümü lockfile'a kaydedin. Açık baseURL, miras alınmış özel bir uç nokta yerine OpenAI'ı seçer. Mevcut ajan yapılandırmasını da inceleyin: sağlayıcı geçersiz kılması ve başka bir hizmetten gelen kimlik bilgisi, ikisi de Authorization başlığını kabul ediyor diye uyumlu hâle gelmez.

Responses isteği gönderip yanıtı okuyun

Aşağıdaki kodla astra-example.mjs dosyasını oluşturun, ardından node astra-example.mjs çalıştırın. İstem kısa bir kontrol listesi ister; böylece daha büyük bir iş akışına bağlamadan önce dönen yanıtı inceleyebilirsiniz. İlk istekte otomatik SDK yeniden denemeleri kapalıdır; bu, bağlantı veya hesap hatalarını teşhis etmeyi kolaylaştırır.

status completed olduğunda response.output_text, SDK'nın birleştirilmiş metin çıktısını içerir. Başka bir programın tüketebilmesi veya bir dosyaya yönlendirilebilmesi için bunu standart çıktıya yazdırın. Yanıttan gelen üst verileri yanıttan ayrı tutmak için standart hataya gönderin. Yanıtlar tamamlanmamışsa incomplete_details ve usage değerlerini koruyun ve sıfır olmayan bir çıkış kodu döndürün.

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://api.openai.com/v1',
  maxRetries: 0,
})
const response = await client.responses.create({
  model: 'gpt-6-astra',
  input: 'List three checks for a small code change.',
})
console.error(JSON.stringify({
  id: response.id,
  model: response.model,
  status: response.status,
  usage: response.usage,
  incomplete_details: response.incomplete_details,
}))
if (response.status === 'completed') {
  console.log(response.output_text)
} else {
  process.exitCode = 1
}

Yerel Codex için API anahtarı kimlik doğrulamasını seçin

OpenAI, yerel Codex çalışması için API anahtarıyla girişi belgeler. CLI'da kimlik bilgilerini değiştirmeden önce codex login status komutuyla durumu inceleyin. Aşağıdaki belgelenmiş stdin komutu, bir gizli bilgiyi komut argümanına yapıştırmanızı önler. Girişten sonra etkin kimlik doğrulama yöntemini yeniden kontrol edin ve CLI model bayrağıyla kesin modeli seçin.

Son komut, Astra seçiliyken etkileşimli bir oturum açar. Ajanın doğru dosyaları ve depo talimatlarını okuyabilmesi için proje dizininizde başlayın. Mevcut sağlayıcı geçersiz kılmalarını inceleyin ve etkin hesabı doğrulayın. API anahtarı modu yerel çalışmayı destekler; Codex cloud için ChatGPT kimlik doğrulaması gerekir. Bulut görevini yerelde sürdürmek istiyorsanız çalışan dosyaları ve kalan işin kısa özetini önce yerel projenize getirin.

codex login status
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status
codex --model gpt-6-astra

Yetenekleri istemci yoluyla eşleştirin

Astra Responses ve Chat Completions'ı destekler, ancak araç çağırma Responses gerektirir. İşlevleri veya özel araçları çalıştıran bir ajan için Responses kullanın. Chat seçimlerini okuyacak şekilde yazılmış bir istemci, yalnızca URL'yi değiştirerek Responses çıktısını ayrıştıramaz; yalnızca metin içeren bir smoke testi de araç döngüsünü çalıştırmaz.

Uygulamanızdan küçük bir örnekle her seferinde tek bir yetenek ekleyin. Araçlarda argümanları doğrulayın, işlevi uygulamanızda çalıştırın ve sonucu eşleşen call_id ile Responses üzerinden döndürün. Yapılandırılmış çıktıda şemayı doğrulayın ve tamamlanmamış yanıtları ele alın. Akışta metnin yanı sıra tamamlanma ve iptal olaylarını da işleyin. Bu özellikleri eklerken basit metin isteğini tanı yolu olarak kullanılabilir tutun.

Erişim, hız ve tamamlanma hatalarını ayrı teşhis edin

Yeniden denemeden önce HTTP durumunu ve yapılandırılmış hata alanlarını kullanın. OpenAI hata kılavuzu geçersiz kimlik doğrulamayı, tükenen kredileri, uygulanan harcama sınırlarını ve istek hızı baskısını birbirinden ayırır. Özellikle 429 yanıtı tek başına bir çözüm seçmek için yeterli değildir: error.code değerini ve ilgili hesap ayarlarını inceleyin.

Geçici hız baskısında, varsa Retry-After'a uyun ve sınırlı yeniden denemeler kullanın. Faturalandırma veya harcama sınırı hataları, tekrarlanan istek değil hesap kararı gerektirir. incomplete işaretli bir Responses sonucu farklı bir durumdur ve token tüketmiş olabilir. Redakte edilmiş hata bilgisini ve kullanımı koruyun; zaman aşımını veya eksik makbuzu başarılı ya da ücretsiz bir denemeye dönüştürmeyin.

Sağlayıcı kullanılabilirliği ve kanıt: 5 Eylül 2026

OpenAI, GPT-6 Astra'yı kademeli bir sunumla duyurdu ve model başvurusu resmî API'yi belgeliyor. Buradaki örnekler bu kaynakları izler; bu kılavuz için ücretli bir istek veya Codex kimlik doğrulama değişikliği çalıştırılmadı. 5 Eylül 2026'da herkese açık APIsRouter katalog kontrolü HTTP 200, success: true ve 34 model döndürdü; Astra veya GPT-6 kaydı yoktu.

OpenAI kimlik bilgilerini yalnızca yukarıda gösterilen resmî uç noktayla kullanın. APIsRouter'ın kendi teklifleri için canlı kataloğu kontrol edin. Daha sonraki bir Astra listelemesinde bile uygulamanızda kullanmadan önce kesin model kimliği, fiyatı ve gerekli istemci özellikleri kontrol edilmelidir.

Yanıtı yararlı bir yerel iş akışına bağlayın

Bir işlevi açıklamak ve bir test önermek gibi somut sonucu olan tek bir yerel görev seçin. Ajanı ilgili dosya yolu, beklenen davranış ve test komutuyla besleyin. Kod değişikliğinden sonra diff'i inceleyin ve odaklanmış testleri çalıştırın. Revizyonları kolayca karşılaştırmak için özgün girdiyi ve dönen yanıtı birlikte tutun.

Bir uygulamada tamamlanmış metni inceleme ekranınıza veya belge hattınıza aktarın. Sonraki adım makinece okunabilir veri bekliyorsa, yapılandırılmış çıktı kullanın ve saklamadan önce zorunlu alanları doğrulayın. İstek kimliğini ve kullanımı görevle birlikte tutun ve sınırlı bir yeniden deneme politikası belirleyin. İş akışını ancak temel girdi, yanıt işleme ve tamamlanma kontrolleri birlikte çalıştıktan sonra genişletin.

Sık sorulan sorular