API dla prostego języka i tekstu łatwego do czytania.
Wyślij tekst źródłowy, żądany język docelowy i jeden z dwóch trybów językowych. Simple8 automatycznie rozpoznaje język źródłowy i zwraca ukończony tekst w języku docelowym.
{
"text": "Kompleksowa treść źródłowa w wybranym języku.",
"locale": "pl",
"mode": "simple-language"
}Dostępne przykłady SDK i cURL
Wynik końcowy
POST /api/v2/translate
Tworzy tekst w prostym lub prostym języku i zwraca go bezpośrednio w odpowiedzi HTTP.
Wymagane nagłówki
| Wpis | Wymóg | Celem |
|---|---|---|
| Authorization | Bearer <API_KEY> | Uwierzytelnianie obszaru roboczego |
| Content-Type | wniosek/json | Wskazuje, że wniosek zawiera JSON |
| Accept | wniosek/json | Wymaganie odpowiedzi JSON |
| Idempotency-Key | Wymagana tylko dla zleceń w tle i masowych | Zapobiega duplikatom zleceń tle |
Organ wnioskowy
Żadne inne ustawienie treści nie jest częścią schematu żądania publicznego.
| Połowo | Typ | Wymagane | Wartość dopuszczalna | Opis |
|---|---|---|---|---|
| text | wiersz | - Tak . | Od 1 do 5 000 punktów kodowych Unicode znormalizowanych za pomocą NFC | Tekst źródłowy |
| locale | wiersz | - Tak . | Jeden ze 136 obsługiwanych kodów 2- lub 3-literowych | Język wyjściowy. Język źródłowy jest wykrywany automatycznie. |
| mode | wiersz | - Tak . | simple-language, easy-language | Tryb uproszczenia |
{
"text": "Applicants must provide the required documentation before the deadline.",
"locale": "en",
"mode": "easy-language"
}Organ odpowiedzi
Odpowiedź zawiera ukończony tekst i udokumentowane dane dotyczące użytkowania.
| Połowo | Typ | Opis |
|---|---|---|
| requestId | wiersz | Unikalny identyfikator wsparcia i dzienników |
| locale | wiersz | Wybrany język docelowy |
| mode | wiersz | Wybrany tryb uproszczenia |
| output | wiersz | Tekst gotowy w wybranym języku docelowym |
| usage.inputCharacters | liczba cała | Znaki zliczone dla tego żądania lub 0 dla trafienia w pamięci podręcznej |
| usage.cacheHit | wartość logiczna | Czy wynik pochodzi z 180-dniowej pamięci podręcznej |
{
"requestId": "req_sync_002",
"locale": "en",
"mode": "easy-language",
"output": "You need to send documents.\nSend the documents before the deadline.",
"usage": {
"inputCharacters": 78,
"cacheHit": false
}
}Zachowanie w zakresie weryfikacji
- Brakujące, puste, nieznane lub nieprawidłowe pola zwracają HTTP 400 z kodem błędu invalid_request i szczegółami walidacji.
- Długość tekstu jest mierzona po normalizacji NFC w punktach kodowych Unicode.
- Ustawienie regionalne musi być jednym ze 136 udokumentowanych kodów 2- lub 3-literowych.
- Tryb musi mieć dokładnie wartość simple-language lub easy-language.
- Simple8 automatycznie rozpoznaje język tekstu źródłowego i tworzy wynik w wybranym języku docelowym.