Translator 3.0: BreakSentence

Makale
06/13/2024

Bir metin parçasındaki cümle sınırlarının konumunu belirler.

İstek URL’si

Şuraya bir POST isteği gönderin:

https://api.cognitive.microsofttranslator.com/breaksentence?api-version=3.0

Bkz. Sanal Ağ Translator hizmeti için seçilen ağ ve özel uç nokta yapılandırması ve desteği için Destek.

İstek parametreleri

Sorgu dizesinde geçirilen istek parametreleri şunlardır:

Sorgu Parametresi	Açıklama
api sürümü	Gerekli sorgu parametresi. İstemci tarafından istenen API sürümü. Değer olmalıdır `3.0`.
dil	İsteğe bağlı sorgu parametresi. Giriş metninin dilini tanımlayan dil etiketi. Bir kod belirtilmezse otomatik dil algılama uygulanır.
betiğini çalıştırın	İsteğe bağlı sorgu parametresi. Giriş metni tarafından kullanılan betiği tanımlayan betik etiketi. Bir betik belirtilmezse, dilin varsayılan betiği varsayılır.

İstek üst bilgileri şunlardır:

Üst Bilgiler	Açıklama
Kimlik doğrulama üst bilgileri	Gerekli istek üst bilgisi. Kimlik doğrulaması için kullanılabilir seçeneklere bakın.
İçerik Türü	Gerekli istek üst bilgisi. Yükün içerik türünü belirtir. Olası değerler şunlardır: `application/json`.
İçerik Uzunluğu	İsteğe bağlı. İstek gövdesinin uzunluğu.
X-ClientTraceId	İsteğe bağlı. İsteği benzersiz olarak tanımlamak için istemci tarafından oluşturulan GUID. adlı `ClientTraceId`bir sorgu parametresi kullanarak izleme kimliğini sorgu dizesine eklerseniz bu üst bilgiyi atlayabilirsiniz.

Request body

İsteğin gövdesi bir JSON dizisidir. Her dizi öğesi adlı Textdize özelliğine sahip bir JSON nesnesidir. Tümce sınırları özelliğin Text değeri için hesaplanır. Tek parça metin içeren örnek istek gövdesi şöyle görünür:

[
    { "Text": "How are you? I am fine. What did you do today?" }
]

Aşağıdaki sınırlamalar geçerlidir:

Dizide en fazla 100 öğe olabilir.
Bir dizi öğesinin metin değeri boşluklar dahil 50.000 karakteri aşamaz.
İstekte yer alan metnin tamamı boşluklar da dahil olmak üzere 50.000 karakteri aşamaz.
language Sorgu parametresi belirtilirse, tüm dizi öğelerinin aynı dilde olması gerekir. Aksi takdirde, dil otomatik algısı her dizi öğesine bağımsız olarak uygulanır.

Yanıt gövdesi

Başarılı bir yanıt, giriş dizisindeki her dize için bir sonuç içeren bir JSON dizisidir. Sonuç nesnesi aşağıdaki özellikleri içerir:

sentLen: Metin öğesindeki cümlelerin uzunluklarını temsil eden tamsayı dizisi. Dizinin uzunluğu tümce sayısıdır ve değerler her cümlenin uzunluğudur.
detectedLanguage: Algılanan dili aşağıdaki özellikler aracılığıyla açıklayan bir nesne:
- language: Algılanan dilin kodu.
- score: Sonuçtaki güveni gösteren float değeri. Puan sıfır (0) ile bir (1,0) arasındadır. Düşük puan (<= 0,4) düşük güveni gösterir.

detectedLanguage özelliği yalnızca dil otomatik algıla işlemi istendiğinde sonuç nesnesinde bulunur.

Örnek bir JSON yanıtı:

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "sentLen": [
            13,
            11,
            22
        ]
    }
]

Yanıt üst bilgileri

Üst Bilgiler	Açıklama
X-RequestId	hizmet tarafından isteği tanımlamak için oluşturulan ve sorun giderme amacıyla kullanılan değer.

Yanıt durum kodları

Bir isteğin döndürdüğü olası HTTP durum kodları aşağıdadır.

Durum Kodu	Açıklama
200	Başarılı.
400	Sorgu parametrelerinden biri eksik veya geçersiz. Yeniden denemeden önce istek parametrelerini düzeltin.
Kategori 401	İsteğin kimliği doğrulanamadı. Kimlik bilgilerinin belirtildiğini ve geçerli olduğunu denetleyin.
Kategori 403	İstek yetkilendirilmedi. Ayrıntılar hata iletisini denetleyin. Bu yanıt kodu genellikle deneme aboneliğiyle sağlanan tüm ücretsiz çevirilerin kullanıldığını gösterir.
Kategori 429	İstemci istek sınırlarını aştığı için sunucu isteği reddetti.
500	Beklenmeyen bir hata oluştu. Hata devam ederse şunu bildirin: hatanın tarihi ve saati, yanıt üst bilgisinden istek tanımlayıcısı ve istek üst bilgisinden `X-RequestId`istemci tanımlayıcısı `X-ClientTraceId`.
503	Sunucu geçici olarak kullanılamıyor. İsteği yeniden deneyin. Hata devam ederse şunu bildirin: hatanın tarihi ve saati, yanıt üst bilgisinden istek tanımlayıcısı ve istek üst bilgisinden `X-RequestId`istemci tanımlayıcısı `X-ClientTraceId`.

Hata oluşursa, istek bir JSON hata yanıtı döndürür. Hata kodu, hatayı daha fazla kategorilere ayırmak için 3 basamaklı HTTP durum kodunu ve ardından 3 basamaklı bir sayıyı birleştiren 6 basamaklı bir sayıdır. Yaygın hata kodları v3 Çevirmen başvuru sayfasında bulunabilir.

Örnekler

Aşağıdaki örnekte, tek bir cümle için cümle sınırlarının nasıl alın aldığı gösterilmektedir. Hizmet, cümle dilini otomatik olarak algılar.

curl -X POST "https://api.cognitive.microsofttranslator.com/breaksentence?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'How are you? I am fine. What did you do today?'}]"

Aracılığıyla paylaş