AI Sağlayıcı Bağlantısını Test Et

Gönderilen yapılandırmadan geçici bir istemci oluşturur ve kısa bir tamamlama çalıştırır (modelden selam vermesi ve adını söylemesi istenir). Hiçbir şey kaydedilmez. Bir anahtarı, modeli ya da endpoint'i kaydetmeden önce kontrol etmek için kullanın.

Kayıtlı anahtarı kullanmak. Boş api_key, sağlayıcı için kayıtlı anahtarla dener; böylece bir model değişikliği anahtar yeniden yazılmadan kontrol edilebilir. Kayıtlı anahtar yoksa istek 79004 ile reddedilir. Kayıtlı anahtar yalnızca kaydedildiği endpoint'e gönderilir (boş base_url sağlayıcının kendi endpoint'i demektir): başka bir base_url değerini bu anahtarla denemek 10002 (domain 83) ile reddedilir. Başka bir endpoint'i denemek için anahtarı gönderin.

İzin verilen hedefler. Endpoint herkese açık https ya da ortamın listelediği bir küme içi host olmalıdır; diğer her şey hiçbir şey gönderilmeden 10001 (domain 83) ile reddedilir.

Sağlayıcı tarafındaki bir hata yine 200 döner; ok: false olur ve neden error alanında yer alır. Başarıda sample_answer modelin yanıtını taşır.

Yalnızca platform sahibi. Çağıranın düğümü platformun kök düğümü olmalıdır; diğer çağıranlar 403 / 10005 ile reddedilir.

Gerekli izin: ai-provider:update

İstek

POST /v2/admin/ai-providers/test

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
provider	string	Evet	Sağlayıcı anahtarı: claude ya da openai
model	string	Evet	Tamamlamanın çalıştırılacağı model
api_key	string	Hayır	Denemede kullanılacak API anahtarı. Boş değer kayıtlı anahtar demektir
base_url	string	Hayır	API temel URL'si. Boş değer sağlayıcının kendi endpoint'i demektir
timeout	integer	Hayır	Saniye cinsinden istek zaman aşımı, 0 veya daha büyük

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/admin/ai-providers/test' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "provider": "claude",
    "api_key": "",
    "base_url": "",
    "model": "claude-sonnet-4-5",
    "timeout": 30
  }'

Yanıt

{
  "ok": true,
  "latency_ms": 1184,
  "model": "claude-sonnet-4-5",
  "sample_answer": "Hello! I am Claude, a model made by Anthropic."
}

Yanıt Alanları

Alan	Tip	Açıklama
ok	boolean	Tamamlamanın başarılı olup olmadığı
latency_ms	integer	Tamamlamanın milisaniye cinsinden süresi
model	string	Test edilen model
sample_answer	string	Yalnızca ok true olduğunda: modelin yanıtı
error	string	Yalnızca ok false olduğunda: tamamlamanın neden başarısız olduğu

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (provider ya da model eksik, negatif timeout) — details alanına bakın
400	79001	Desteklenmeyen sağlayıcı anahtarı (domain 79)
400	79004	api_key boş ve sağlayıcı için kayıtlı anahtar yok (domain 79)
400	10001	Hedef reddedildi: https değil, çözümlenemiyor ya da özel veya metadata adresine çözümleniyor (domain 83)
400	10002	Kayıtlı anahtar, kaydedildiği endpoint dışındaki bir endpoint'e gönderilecekti (domain 83)
403	10005	Çağıran platform sahibi değil (domain 2)

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.