MGModel Gate
Oturum açBaşlayın

Geri aramalar

İmzalı sunucular arası bildirimleri ve tamamlanmış eşzamansız sonuçları alın.

Geri aramalar

Bir geri arama URL'sini yapılandırın Profil → Geri aramalar ve eşzamansız sonuçlar. Model Kapısı HTTPS gönderir POST Etkinleştirilmiş hesap bildirimlerine ve tamamlanmış eşzamansız çıkarım isteklerine yönelik istekler.

Geri arama URL'si

Herkese açık olarak erişilebilen bir HTTPS uç noktası kullanın. Uç nokta ham istek gövdesini okumalı, imzayı doğrulamalı, olayı bağımsız olarak işlemeli ve HTTP'yi döndürmelidir. 200 Etkinlik kabul edilir edilmez.

Olaylar

Geri aramalar şunları içerebilir:

  • tamamlanmış eşzamansız çıkarım sonuçları;
  • etkinleştirildiğinde düşük hesap bakiyesi bildirimleri;
  • Etkinleştirildiğinde API anahtarı harcama sınırı bildirimleri;
  • Etkinleştirildiğinde anahtar grup harcama sınırı bildirimleri.

Async result delivery is enabled whenever a callback URL is configured. The notification checkboxes in Profile control only the corresponding balance and limit alerts.

Talep formatı

POST /model-gate/callback HTTP/1.1
Content-Type: application/json
X-Model-Gate-Signature: t=1710000000,v1=hex_hmac_sha256

Örnek eşzamansız sonuç yükü:

{
  "event":"async.completed",
  "request_id":"01J...",
  "status":"completed",
  "response":{"id":"msg_...","type":"message"}
}

Yük alanları zamanla genişletilebilir. Bilinmeyen alanları yoksay.

İmza doğrulama

İmza başlığı şu formata sahiptir:

X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>

HMAC-SHA256'yı tam dize üzerinden hesaplayın <timestamp>.<raw_body> Profil'de gösterilen geri arama sırrını kullanarak. Onaltılı imzayı sabit zamanlı bir karşılaştırmayla karşılaştırın ve kabul edilen yeniden oynatma pencerenizin dışındaki zaman damgalarını reddedin.

Teslimat ve yeniden denemeler

HTTP'yi döndür 200 Etkinliği güvenli bir şekilde kabul ettikten sonra. 2xx olmayan yanıtlar ve bağlantı hataları yeniden denenebilir. Bu nedenle uç noktanız bağımsız olmalıdır; kullanmak request_id birlikte event tekilleştirme anahtarı olarak.

Yanıt vermeden uzun süreli işler yapmayın. Etkinliği dahili olarak sıraya alın, geri dönün 200ve bunu eşzamansız olarak işleyin.

İlgili belgeler