Partner API SSS

Hesap API anahtarı ile Model API anahtarı arasındaki fark nedir?

Hesap düzeyindeki API anahtarı (mg_partner_...) aracılığıyla Model API anahtarlarını yönetir https://p-api.model-gate.com/api/v1/partner/* ve aracılığıyla asenkron sonuçları alır https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Bir Model API anahtarı (mg_live_...) çıkarım isteklerinin kimliğini doğrular https://api.model-gate.com.

Hiçbir zaman hesap düzeyinde Partner API anahtarını bir çıkarım uç noktasına göndermeyin veya istemci tarafı uygulamalarda açığa çıkarmayın.

Hangi sayaç uygulanır spend_limit?

Sıfırlanabilir usage sayaç limiti zorlar. POST /api/v1/partner/keys/{key_public_id}/reset-usage tuş sayacını temizler. total_spent ömür boyu muhasebedir ve asla sıfırlanmaz.

Her Model API anahtarının ayrı bir hesap bakiyesi var mı?

Hayır. Tüm Model API anahtarları, sahip olunan Model Gate hesap bakiyesinden harcanır. Anahtar başına ve grup limitleri, hesap bakiyesini alt bakiyelere bölmeden kullanımı kısıtlar.

Bir Model API anahtarı döndürüldüğünde ne olur?

Eski sır hemen çalışmayı bırakır. Döndürme yanıtı yeni düz metin sırrını bir kez içerir. Model Gate sırrın tamamını bir daha göstermediğinden onu güvenli bir şekilde saklayın.

Geri aramalar nasıl yapılandırılır?

Yapılandır callback_url ve döndür callback_secret Model Kapısı profilinde. Bir geri arama URL'si mevcut olduğunda eşzamansız tamamlama sonuçları gönderilir. İsteğe bağlı düşük anahtar limiti, Anahtar Grup limiti ve düşük hesap bakiyesi olayları ayrı ayrı etkinleştirilebilir; bunların eşikleri Profil bildirimlerinde yapılandırılır.

Geri arama teslimi dayanıklıdır ve çıkarım işleminden bağımsızdır. Her olay bir kararlılık taşır event_id bu, yeniden denemelerde değişmeden kalır ve tüketici veri tekilleştirmesi için kullanılması gerekir. Herhangi bir HTTP 2xx yanıt başarılı. Teslimat, 5 saniye, 30 saniye, 2 dakika, 10 dakika ve 1 saat sonraki yeniden denemelerle birlikte toplamda en fazla 6 deneme kullanır; her denemenin 15 saniyelik bir genel molası vardır. Aktarım hataları, zaman aşımları ve 2xx olmayan yanıtlar yeniden denenir ve altıncı başarısız denemeden sonra olay işaretlenir failed başka otomatik yeniden deneme olmadan. Görmek Geri aramalar etkinlik kataloğu, tam ondalık yükler, imzalar, varış yeri güvenliği ve teslimat ayrıntıları için.

Eşzamansız bir sonuç ne kadar süreyle alınabilir?

Eşzamansız bir sonuç 24 saat boyunca kullanılabilir durumda kalır. GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Süre dolduktan sonra saklanan istek ve yanıt silinir ve uç nokta geri döner 404.

İş Ortağı mutasyonları güvenli yeniden denemeyi destekliyor mu?

Evet. Her Partner API POST, PATCH, Ve DELETE gereklilikler Idempotency-Key. Bir zaman aşımından sonra aynı mantıksal işlemi aynı anahtarla yeniden deneyin; 7 gün boyunca Model Gate, mutasyonu tekrar yürütmeden orijinal sonucu döndürür. Bir anahtarı farklı bir istek için yeniden kullanma sonuçları 409.

Ayrıntılı istek geçmişi ne kadar süreyle kullanılabilir?

Ayrıntılı İş Ortağı istek geçmişi aşağıdadır API_REQUESTS_HOT_RETENTION_DAYS (varsayılan 7 gün) ve bu pencereyi yanıt meta verilerinde bildirir. Daha uzun vadeli mali mutabakat için imleçle sayfalandırılmış hesap bakiyesi işlemlerini kullanın.