GPT-6 Astra ile OmniaKey

Bu rehber yeni bir OmniaKey hesabından başarılı ilk GPT-6 Astra isteğine kadar tüm temel adımları kapsar. Sunucu tarafı API çağrılarını ve Codex CLI yapılandırmasını anlatır. OmniaKey API anahtarı bir ChatGPT aboneliği değildir ve ChatGPT web sitesine girilemez.

OpenAI'nin güncel Astra rehberi Responses API ile başlar. Chat Completions düz metin için kullanılabilir, ancak Astra tool calling Responses gerektirir. Aşağıdaki örnekler bu sınırı korur ve anahtarı kaynak koda yazmak yerine ortam değişkeninden okur.

Başlamadan önce

Sınırlı bir API anahtarı oluşturun

OmniaKey'e giriş yapıp API Keys sayfasını açın. Bu entegrasyon için ayrı bir anahtar oluşturun; teste uygun kota ve son kullanma tarihi belirleyin. Anahtar göründüğünde hemen kopyalayın.

Hesabın kullanılabilir bakiyesi de olmalıdır. Anahtarın oluşması kimlik bilgisinin varlığını gösterir, isteği karşılayacak bakiyeyi garanti etmez.

Anahtarı parola gibi koruyun. Git'e göndermeyin, tarayıcı JavaScript'ine yazmayın, ekran görüntüsüne veya mesaja eklemeyin.

Anahtarı ortam değişkenine koyun

macOS veya Linux:

PowerShell:

$env:OMNIAKEY_API_KEY="your-omniakey-api-key"

SDK ve Codex örnekleri aynı değişkeni okur.

İlk Responses API isteğini gönderin

Terminalde çalıştırın:

curl https://api.omniakey.com/v1/responses \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "reasoning": {"effort": "medium"},
    "input": "Bu geçiş planını incele. En büyük iki riski ve her biri için bir kabul testi döndür."
  }'

Başarılı yanıtta output dizisi, üretilen metin ve token kullanımı bulunur. Bu tek çağrı Base URL, anahtar, bakiye, model izni, model ID ve Responses rotasını birlikte doğrular.

Başarıdan sonra kullanım panelini açıp kaydedilen modelin gpt-6-astra olduğunu doğrulayın. Maliyeti yalnızca görünür metinden tahmin etmek yerine gerçek input, cached input, reasoning ve output kullanımına bakın.

Python ile Astra çağrısı

OpenAI'nin resmi Python SDK'sını kurun veya güncelleyin:

python -m pip install --upgrade openai

astra_example.py oluşturun:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OMNIAKEY_API_KEY"],
    base_url="https://api.omniakey.com/v1",
)

response = client.responses.create(
    model="gpt-6-astra",
    reasoning={"effort": "medium"},
    input="Bu olay raporunu açıkla ve en yararlı üç takip kontrolünü listele.",
)

print(response.output_text)

Çalıştırın:

python astra_example.py

response.output_text, üretilen metni veren SDK kolaylık alanıdır. Usage, status veya tool-call öğeleri gerekiyorsa yanıt nesnesinin tamamını saklayın.

Node.js ile Astra çağrısı

SDK'yı kurun:

npm install openai

astra-example.mjs adlı sunucu tarafı dosyası oluşturun:

import OpenAI from "openai";

const apiKey = process.env.OMNIAKEY_API_KEY;
if (!apiKey) throw new Error("OMNIAKEY_API_KEY is required");

const client = new OpenAI({
  apiKey,
  baseURL: "https://api.omniakey.com/v1",
});

const response = await client.responses.create({
  model: "gpt-6-astra",
  reasoning: { effort: "medium" },
  input: "Bu API tasarımını incele. İki hata modu ve her biri için bir test bul.",
});

console.log(response.output_text);

Ortam değişkeninin ayarlı olduğu terminalde çalıştırın:

node astra-example.mjs

Bu kodu sunucuda, yerel makinede veya güvenilir bir worker içinde çalıştırın. Frontend bundle içindeki anahtar ziyaretçilere açılır.

Codex CLI içinde GPT-6 Astra kullanın

Codex, custom provider ile Responses wire formatını kullanır. ~/.codex/config.toml içine şunları ekleyin:

model = "gpt-6-astra"
model_provider = "omniakey"

[model_providers.omniakey]
name = "OmniaKey"
base_url = "https://api.omniakey.com/v1"
env_key = "OMNIAKEY_API_KEY"
wire_api = "responses"

Codex'i anahtarın bulunduğu shell'den başlatın:

export OMNIAKEY_API_KEY="your-omniakey-api-key"
codex

requires_openai_auth değerini tanımlamayın. Resmi Codex yapılandırma referansı bunu OpenAI kimlik doğrulama bayrağı olarak tanımlar; bu custom provider bunun yerine env_key kullanır.

Önce Codex'in gösterdiği modeli kontrol edin, ardından değişikliğe izin vermeden küçük ve salt okunur bir görev çalıştırın. Doğrudan cURL başarılı, Codex başarısızsa önce istemci yapılandırmasını kontrol edin.

Yalnızca istemci gerektiriyorsa Chat Completions kullanın

GPT-6 Astra, Chat Completions üzerinden düz metin kabul eder. Responses desteklemeyen istemcide şu rotayı kullanın:

curl https://api.omniakey.com/v1/chat/completions \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "reasoning_effort": "medium",
    "messages": [
      {"role": "user", "content": "Bu yayın planındaki iki ana riski özetle."}
    ]
  }'

Parametre farkına dikkat edin: Responses reasoning.effort, Chat Completions ise reasoning_effort kullanır. Bu örneğe Astra araçları eklemeyin. OpenAI'nin güncel rehberi tool calling için Responses gerektirir.

Reasoning effort seçimi

Astra low, medium, high, xhigh ve max destekler; none desteklemez. Yüksek effort doğruluğu garanti etmeden reasoning işini, gecikmeyi ve output token maliyetini artırabilir. Kabul testini geçen en düşük değeri kullanın.

Astra'ya doğrulanabilir bir görev verin

İyi bir ilk prompt hedefi, bağlamı, kısıtları ve tamamlanma ölçütünü açıklar:

Hedef: bu veritabanı geçişinin yayın riskini incele.
Bağlam: PostgreSQL 15, production'da tek writer, rollback beş dakika içinde bitmeli.
Kısıtlar: yıkıcı komut önerme; doğrulanmış gerçekleri varsayımlardan ayır.
Tamamlanma: en büyük üç risk, her biri için bir azaltma ve bir kabul testi döndür.

Kodlama görevlerinde depo kurallarını ve tamamlanmayı kanıtlayan kesin komutu da yazın. Astra erişebildiği talimat dosyalarını dikkatle izler; araç izni vermeden önce AGENTS.md, skills ve benzer dosyaları inceleyin.

Yaygın kurulum hatalarını çözün

401, unauthorized veya geçersiz API anahtarı

Komutu çalıştıran shell içinde OMNIAKEY_API_KEY ayarlı olmalıdır. Ortam değişkenine yalnızca anahtarı koyun; Bearer HTTP header içinde yer alır. Anahtarın etkin ve süresinin dolmamış olduğunu kontrol edin.

Yetersiz bakiye veya kota

Hem hesap bakiyesini hem anahtarın kendi kotasını kontrol edin. Bakiyeli hesapta bile sınırlı anahtar üst sınırına ulaşmış olabilir.

Model bulunamadı veya kullanılamıyor

Kesin ID olan gpt-6-astra değerini kullanın. Canlı model sayfasını açıp anahtar iznini doğrulayın. GPT 6 gibi görünen adlar API ID değildir.

Desteklenmeyen parametre

temperature, top_p ve top_logprobs alanlarını kaldırın. Chat Completions'tan logprobs, Responses include listesinden message.output_text.logprobs da kaldırılmalıdır. Astra bu parametreleri desteklemez.

Yanıt incomplete veya görünür metin yok

max_output_tokens değerini artırın ve output_tokens_details.reasoning_tokens alanını inceleyin. Reasoning tokenları görünür yanıt tamamlanmadan önce output bütçesini kullanır.

Sohbet çalışıyor, araçlar çalışmıyor

Workflow'u /v1/responses rotasına taşıyın. Önce düz metni doğrulayın, ardından tek bir araç ekleyip request, result, timeout ve izin yolunu kontrol edin. OpenAI'nin resmi araç listesi modelin doğrudan yeteneğini açıklar; ağ geçidi veya istemci daha dar bir yüzey sunabilir.

Codex başka modeli kullanmaya devam ediyor

Etkin Codex yapılandırmasındaki model, model_provider, base_url, env_key ve wire_api değerlerini kontrol edin. OMNIAKEY_API_KEY ayarlı shell'den Codex'i yeniden başlatın.

Production öncesi maliyeti doğrulayın

Temsili bir görev çalıştırın, kullanım kaydını kontrol edin ve tekrarları toplam maliyete ekleyin. Canlı Astra sayfası güncel OmniaKey fiyatını içerir; Astra incelemesi bu fiyatı OpenAI'nin doğrudan oranlarından ayırır ve doğrudan fiyatın 272K sınırını açıklar.

Kullanım limiti işinizi durdurduysa Codex kullanım limiti rehberi, yenilenme saatini kontrol etmeyi ve ek kredi, plan değişikliği veya ayrı ücretlendirilen yerel API kullanımını karşılaştırmayı açıklar.

Kaynaklar

Aşağıdaki resmi OpenAI kaynaklarının tümü İngilizce yayımlanmıştır.

• OpenAI: GPT-6 Astra modeli
• OpenAI: Using GPT-6 Astra
• OpenAI: Codex yapılandırma referansı
• OmniaKey API hızlı başlangıç
• OmniaKey OpenAI uyumlu API
• OmniaKey Codex CLI rehberi