API referansı: yapay zekâ

Yapay zekâ uç noktaları, yapay zekâ istemlerini eşzamansız olarak çalıştırır ve sonucu sorgulamanıza olanak tanır.

Doğrudan yapay zekâ istemi başlatın (eşzamansız; aynı gövdeyle POST …/ai/{promptType}/status sorgusu gönderin)

Uç nokta: POST /v1/tenant/{tenantId}/ai/{promptType}

Kimlik doğrulama: Tenant kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad	Tür	Konum	Gerekli	Açıklama
tenantId	string	path	Evet	Biçim: uuid
promptType	processAnalysis | processQuestion | aiSummary | processDocumentation | processRaci | processMetaEdit	path	Evet	İzin verilen değerler: processAnalysis, processQuestion, aiSummary, processDocumentation, processRaci, processMetaEdit

İstek gövdesi:

{
	"prompt": "string",
	"summaryVariant": "string"
}

Alan	Tür	Gerekli	Açıklama
prompt	string	Evet	Doğal dil istemi Maksimum uzunluk: 10000
summaryVariant	string	Hayır

Yanıt (200):

Yapay zekâ sonucu (durum: success | generating | error)

{
	"status": "success",
	"result": {
		"type": "processAnalysis",
		"analysis": "string"
	},
	"error": "string"
}

Alan	Tür	Gerekli	Açıklama
status	success | error | generating	Evet	İzin verilen değerler: success, error, generating
result	object | object | object | object | object | object	Hayır	İsteme özel sonuç yükü (status success olduğunda bulunur)
error	string	Hayır	status error olduğunda hata mesajı

Hatalar:

• 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
• 429 Kullanım sınırına ulaşıldı

Devam eden yapay zekâ oluşturma işlemini sorgulayın (başlatan POST isteğiyle tam olarak aynı gövdeyi gönderin)

POST ile sorgulama bilinçli bir tercihtir: oluşturma işlemi prompt + promptType + summaryVariant ile belirlenir. Bu nedenle sorgu, bir çalıştırma kimliğine başvurmak yerine gövdeyi tekrar gönderir.

Uç nokta: POST /v1/tenant/{tenantId}/ai/{promptType}/status

Kimlik doğrulama: Tenant kapsamlı API anahtarı · write kapsamı

Parametreler:

Ad	Tür	Konum	Gerekli	Açıklama
tenantId	string	path	Evet	Biçim: uuid
promptType	processAnalysis | processQuestion | aiSummary | processDocumentation | processRaci | processMetaEdit	path	Evet	İzin verilen değerler: processAnalysis, processQuestion, aiSummary, processDocumentation, processRaci, processMetaEdit

İstek gövdesi:

{
	"prompt": "string",
	"summaryVariant": "string"
}

Alan	Tür	Gerekli	Açıklama
prompt	string	Evet	Doğal dil istemi Maksimum uzunluk: 10000
summaryVariant	string	Hayır

Yanıt (200):

Yapay zekâ sonucu (durum: success | generating | error)

{
	"status": "success",
	"result": {
		"type": "processAnalysis",
		"analysis": "string"
	},
	"error": "string"
}

Alan	Tür	Gerekli	Açıklama
status	success | error | generating	Evet	İzin verilen değerler: success, error, generating
result	object | object | object | object | object | object	Hayır	İsteme özel sonuç yükü (status success olduğunda bulunur)
error	string	Hayır	status error olduğunda hata mesajı

Hatalar:

• 401 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
• 429 Kullanım sınırına ulaşıldı