json i markdown.
Dokument ten szczegółowo opisuje instrukcje integracji API Tłumaczenia, aby pomóc Ci łatwo zintegrować i w pełni wykorzystać potężne możliwości tego API. Dzięki API Tłumaczenia możesz łatwo przetłumaczyć wprowadzony tekst na określony język, a także wspierać określone metody wyjścia wyników tłumaczenia.
Proces aplikacji
Aby korzystać z API Tłumaczenia Lokalizacji, najpierw przejdź do Konsoli Ace Data Cloud, aby uzyskać swój token API, który należy zachować na przyszłość.
Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę.
Jeden token API wystarczy do wywołania wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Przy pierwszym wniosku otrzymasz darmowy limit, aby móc go przetestować; w przypadku niewystarczającego limitu możesz doładować saldo ogólne w konsoli.
📘 Pełna dokumentacja: API Tłumaczenia Lokalizacji →
Przykład żądania
Weźmy przykład z angielskim wejściem, aby pokazać, jak używać tego API. Załóżmy, że angielski opis to:# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph., następnie pokażemy, jak przesłać angielski opis i uzyskać tłumaczenie na chiński, a także jak zaprezentować to w formacie markdown.
Ustawienie nagłówków żądania i ciała żądania
Nagłówki żądania obejmują:accept: określa, że oczekiwany jest wynik w formacie JSON, tutaj wpiszapplication/json.authorization: klucz do wywołania API, po złożeniu wniosku można go bezpośrednio wybrać z rozwijanej listy.
input: przesyłany tekst do przetłumaczenia.locale: dostosowany język tłumaczenia.extension: dostosowana forma wyświetlania wyników tłumaczenia.model: duży model używany do tłumaczenia, domyślnie to gpt-3.5.
Przykład kodu
Można zauważyć, że po prawej stronie strony automatycznie wygenerowano różne kody w różnych językach, jak pokazano na obrazku:
CURL
Python
Przykład odpowiedzi
Po pomyślnym wykonaniu żądania API zwróci informacje o wynikach tego zadania tłumaczenia. Na przykład:data, które zawiera przetłumaczony tekst w języku chińskim, a także zwraca go w formacie markdown, inne informacje są następujące:
data, wynik tego zadania tłumaczenia.model, duży model językowy użyty w tym zadaniu tłumaczenia.locale, typ języka tłumaczenia w tym zadaniu.
Obsługa błędów
Podczas wywoływania API, jeśli wystąpią błędy, API zwróci odpowiednie kody błędów i informacje. Na przykład:400 token_mismatched: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.400 api_not_implemented: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacji.429 too_many_requests: Zbyt wiele żądań, przekroczono limit.500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.