ReferansGPT Image 2.5 Kararlı

TopviewAI Pro Studio API rehberi

API anahtarlarını yönetin ve oturum açılmış Studio isteklerini öğrenin. Aşağıdaki görsel örneği GPT Image 2.5 kullanır; diğer modellerin istek biçimleri farklıdır.

https://topviewai.pro

Hızlı başlangıç

İlk API çağrınızı yalnızca iki adımda tamamlayın: bir üretim görevi gönderin ve ardından durumu sorgulayın.

Görev gönder

Bir görev kimliği (Task ID) almak için generate uç noktasına POST isteği gönderin.

Durumu sorgula

Görsel URL’sini alana kadar ilerlemeyi kontrol etmek için görev kimliğini kullanın.

Kimlik doğrulama

Bu Studio uç noktaları için açık oturum ve API anahtarı gerekir. Yalnızca Bearer anahtarı yeterli değildir. Anahtarınızı gizli tutun.

HTTP başlığı

Authorization: Bearer {YOUR_API_KEY}

POST

https://topviewai.pro/api/image/gpt-image-2-5/generate

GPT Image 2.5 görsel isteği gönderin. Yanıt bir task_id döndürür; sonucu ilgili durum uç noktasından sorgulayın.

İstek asenkrondur: task_id değerini saklayın ve SUCCESS veya sonlandırıcı hata gelene kadar durumu sorgulayın.

Gövde parametreleri

Parametre adı	Tür	Zorunlu	Açıklama
`prompt`	string	Evet	Görseli 1–20.000 karakterle açıklayın.
`aspect_ratio`	string	Hayır	İsteğe bağlı en boy oranı; varsayılan auto. Örnekler: 1:1, 4:3, 3:4, 16:9, 9:16.

Yanıt (JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://topviewai.pro/api/image/gpt-image-2-5/status

Bir görevin yürütme durumunu ve sonuçlarını sorgular.

Sorgu parametreleri

Parametre adı	Zorunlu	Açıklama
`task_id`	Evet	Görev gönderilirken döndürülen kimlik.

Yanıt örneği

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "Dağların üzerinde gün batımı",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 4,
    "created_at": "2026-11-05 13:05:09",
    "error_message": null
  }
}

Faturalandırma

GPT Image 2.5 maliyet örneği

4 kredi / 1K görsel

Maliyet modele, çözünürlüğe ve ayarlara göre değişir. Studio tahminini ve görevin bildirdiği kredi kullanımını kontrol edin.

Hata yönetimi

401 UnauthorizedGeçersiz API anahtarı
402 Payment RequiredYetersiz bakiye
429 Too Many RequestsÇok fazla istek

TopviewAI Pro hakkında

Video, görsel, düzenleme, konuşma ve ses için ortak Studio.

Her iş için model seçin

Video için Seedance 2.5, görsel için GPT Image 2.5 ve Studio’daki diğer modelleri kullanın. Her model gerçek adıyla gösterilir.

Tek bakiye, modele göre maliyet

Abonelik veya kullandıkça tek seferlik yükleme seçin. Krediler kullandığınız model ve araçların maliyetini karşılar.

Görsel araçları Video araçları