GPT-Image 2.6 Flare ve Sunburst yayındaGörsel başına $0.025 ile başlar
OmniaKey
Giriş yap

API anahtarı kurulumu

GPT Image API anahtarı: alma, yapılandırma ve test

GPT Image API anahtarını yapılandırmadan önce anahtarı kimin verdiğini seçin. Anahtar, API URL’si ve model kimliği birbiriyle eşleşmelidir. Aşağıdaki adımlar OmniaKey üzerinden erişimi yapılandırır.

Resmi sağlayıcı anahtarı

Doğrudan OpenAI tarafından verilen ve faturalandırılan bir anahtar için sağlayıcının kendi hesap ve API anahtarı talimatlarını izleyin.

Resmi anahtar talimatlarını aç

OmniaKey API anahtarı

Hesabınızda kullanılabilen modeller için tek bir OmniaKey bakiyesi ve anahtarı kullanın. Anahtar, OmniaKey uç noktasıyla çalışır.

API anahtarı al

01Bir OmniaKey API anahtarı oluşturun

Oturum açın, API Anahtarları bölümünü açın ve uygulamanız için bir anahtar oluşturun. Kotasını, son kullanma tarihini ve model kısıtlamalarını inceleyin. Oluşturma isteklerini çalıştırmadan önce bakiye ekleyin.

API anahtarı al

02Anahtarı ve API URL'sini ayarlayın

Komutları kendi terminalinizde çalıştırın ve yer tutucuyu anahtarınızla değiştirin. Anahtarı sunucunuzda veya bir gizli bilgi yöneticisinde tutun. Tarayıcı koduna veya herkese açık bir depoya asla koymayın.

bash / zsh
export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03Kimlik doğrulamayı kontrol edin

Oluşturma işi başlatmadan model listesini isteyin. Başarılı yanıt, data dizisi içeren bir JSON'dur. Bu, anahtar erişimini kontrol eder; hesabınız için tüm modellerin etkin olduğunu göstermez.

GET /v1/models
curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04Modelin istek biçimini kullanın

Aile sayfasından bir model seçin, API kimliğini kopyalayın ve ilgili API belgelerini izleyin. Kimlik doğrulama tek başına oluşturma parametrelerinizi kontrol etmez.

Görsel ve video oluşturma POST /v1/media/tasks kullanır. Aynı gönderimi yeniden denerken aynı Idempotency-Key değerini koruyun, dönen görev kimliğini kaydedin ve sonucu almak için GET /v1/media/tasks/{id} adresini yoklayın.

Örnek oluşturma isteği (ücretli)

Bu istek hesap bakiyenizi kullanır. Önce seçilen modelin fiyatını kontrol edin. Örnek, belgelenen istek biçimini izler; hesabınızın yine de modele erişimi olması gerekir.

POST /v1/media/tasks
curl --fail-with-body 'https://api.omniakey.com/v1/media/tasks' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: gpt-image-first-request-001" \
  -d '{
  "model": "gpt-image-2.6-flare",
  "type": "image",
  "operation": "generate",
  "input": {
    "prompt": "A paper boat on a quiet lake at sunset."
  },
  "parameters": {
    "size": "1024x1024",
    "quality": "medium"
  }
}'

Medya görevini yokla

YOUR_TASK_ID yerine oluşturma isteğinin döndürdüğü id değerini koyun. Görev son duruma gelene kadar yoklayın. Başarılı bir görev için assets içindeki URL'leri süreleri dolmadan indirin. Yeni bir idempotency anahtarını yalnızca yeni bir görev için kullanın.

GET /v1/media/tasks/{id}
curl --fail-with-body "https://api.omniakey.com/v1/media/tasks/YOUR_TASK_ID" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"
API belgelerini okuyun

Bağlantı başarısız olursa

  • 401: anahtarın eksiksiz, etkin ve çağırdığınız API URL'si için verilmiş olduğunu kontrol edin.
  • 403: anahtarın model kısıtlamalarını ve hesabınızın kullanabileceği izinleri kontrol edin.
  • JSON yerine 404 veya HTML: API ana bilgisayarını ve sürüm önekini kontrol edin. Web sitesi adresi yerine api.omniakey.com kullanın.
  • 429: eşzamanlılığı azaltın ve yanıttaki yeniden deneme önerisine uyun. Oluşturma görevlerini yeni idempotency anahtarlarıyla tekrar tekrar göndermeyin.