AI Sağlayıcısını Kaydet

Bir AI sağlayıcısının yapılandırmasını ve hizmet ettiği AI özelliklerini oluşturur ya da günceller. Kaydedilen yapılandırma bir sonraki AI çağrısında kullanılır; etkinleştirilmesi gereken bir şey yoktur.

api_key bilerek null olabilir. Anahtarı geri okuyamazsınız; bu yüzden onu göndermeyen bir kayıt kayıtlı anahtarı korur:

gönderilmezse ya da null ise kayıtlı anahtar korunur (bir sağlayıcının ilk kaydı anahtar taşımalıdır);
boş olmayan bir metin onun yerine geçer;
boş metin reddedilir: bir sağlayıcı anahtarsız kaydedilemez.

Kayıtlı bir anahtar yalnızca kaydedildiği endpoint'e gönderilir. Kayıtlı anahtarı koruyarak base_url değerini başka bir köke değiştirmek api_key alanını belirten 10015 ile reddedilir: anahtarı yeniden gönderin. Boş base_url sağlayıcının kendi endpoint'i sayılır.

Varsayılanlar. Boş base_url sağlayıcının endpoint'i olarak (claude için https://api.anthropic.com, openai için https://api.openai.com), 0 değerindeki timeout 60 saniye ve 0 değerindeki max_tokens 1024 olarak kaydedilir. Yanıt kaydedilen değerleri gösterir.

Özellikler. features tam listedir ve kayıtlı listenin yerine geçer; gönderilmezse liste silinir. is_enabled kapatıldığında özellikler korunur; yeniden açıldığında aynı kapsam geri gelir. is_enabled gönderildiği gibi yazılır: gönderilmezse sağlayıcı devre dışı kalı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

PUT /v2/admin/ai-providers/{provider}

Parametreler

Ad	Tip	Konum	Açıklama
`provider`	string	path	Zorunlu. Sağlayıcı anahtarı: `claude` ya da `openai`

Başlıklar

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

Gövde

Alan	Tip	Zorunlu	Açıklama
`api_key`	string \| null	Koşullu	Sağlayıcı API anahtarı. İlk kayıtta zorunlu; sonrasında `null` kayıtlı anahtarı korur
`base_url`	string	Hayır	API temel URL'si. Boş değer sağlayıcının kendi endpoint'i demektir
`model`	string	Evet	Metin özellikleri için kullanılan model (ör. `claude-sonnet-4-5`, `gpt-4o`)
`image_model`	string	Koşullu	`tokenization_image` için kullanılan model (ör. `gpt-image-1`). `features` içinde `tokenization_image` varsa zorunlu; önceden de kaydedilebilir
`timeout`	integer	Hayır	Saniye cinsinden istek zaman aşımı, 0 veya daha büyük. `0` 60 demektir
`max_tokens`	integer	Hayır	Token cinsinden azami yanıt uzunluğu, 0 veya daha büyük. `0` 1024 demektir
`is_enabled`	boolean	Hayır	Ana anahtar. Gönderilmezse `false`
`features`	array of string	Hayır	Bu sağlayıcının hizmet ettiği AI özellikleri: `tokenization_suggestion`, `support_assistant`, `tokenization_image`. Her biri en fazla bir kez. `tokenization_image` yalnızca `openai` için

Örnek

curl --request PUT \
  --url '{{baseUrl}}/v2/admin/ai-providers/openai' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "api_key": "<openai_api_key>",
    "base_url": "",
    "model": "gpt-4o",
    "image_model": "gpt-image-1",
    "timeout": 0,
    "max_tokens": 0,
    "is_enabled": true,
    "features": ["tokenization_suggestion", "tokenization_image"]
  }'

Yanıt

Kaydedilen sağlayıcıyla birlikte 200 OK; AI Sağlayıcılarını Listele sayfasındaki gibi maskelenmiştir.

{
  "provider": "openai",
  "base_url": "https://api.openai.com",
  "model": "gpt-4o",
  "image_model": "gpt-image-1",
  "timeout": 60,
  "max_tokens": 1024,
  "is_enabled": true,
  "features": ["tokenization_suggestion", "tokenization_image"],
  "api_key_set": true,
  "api_key_last4": "Zk8w",
  "configured": true,
  "created_at": "2026-11-09T11:31:56.218Z",
  "updated_at": "2026-11-09T11:31:56.218Z"
}

Hatalar

Durum	Kod	Açıklama
400	`10015`	Doğrulama başarısız (`model` eksik, negatif `timeout` ya da `max_tokens`) — `details` alanına bakın. Ayrıca (`api_key` alanını belirten `details` ile) yeni bir endpoint'e taşınacak kayıtlı anahtar
400	`79001`	Desteklenmeyen sağlayıcı anahtarı (domain `79`)
400	`79002`	Bilinmeyen özellik ya da iki kez listelenmiş özellik (domain `79`)
400	`79004`	API anahtarı yok: ilk kayıt anahtar taşımıyor ya da `api_key` boş metin (domain `79`)
400	`79008`	Sağlayıcı listelenen bir özelliğe hizmet edemez (`claude` için `tokenization_image`) (domain `79`)
400	`79009`	`image_model` olmadan `tokenization_image` listelendi (domain `79`)
403	`10005`	Çağıran platform sahibi değil (domain `2`)

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

İstek​

Parametreler​

Başlıklar​

Gövde​

Örnek​

Yanıt​

Hatalar​