Przejdź do głównej treści
Główną funkcją API Tłumaczenia Lokalizacji jest uzyskanie przetłumaczonego tekstu poprzez wprowadzenie tekstu do przetłumaczenia, a język tłumaczenia można dostosować, a wyniki tłumaczenia mogą być wyjściem w dwóch głównych formatach: 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, należy najpierw przejść do strony aplikacji API Tłumaczenia Lokalizacji, aby ubiegać się o odpowiednią usługę. Po wejściu na stronę kliknij przycisk „Acquire”, jak pokazano na obrazku: Strona aplikacji Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować. Po zalogowaniu lub rejestracji automatycznie wrócisz na bieżącą stronę. Podczas pierwszej aplikacji otrzymasz darmowy limit, który pozwala na bezpłatne korzystanie z tego API.

​
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., a następnie pokażemy, jak przesłać angielski opis i uzyskać tłumaczenie na chiński, jednocześnie prezentując je 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 wpisz application/json.
  • authorization: klucz do wywołania API, po aplikacji można go bezpośrednio wybrać z rozwijanej listy.
Ciało żądania obejmuje:
  • input: przesyłany tekst do przetłumaczenia.
  • locale: dostosowany język tłumaczenia.
  • extension: dostosowany format wyświetlania wyników tłumaczenia.
  • model: duży model używany do tłumaczenia, domyślnie to gpt-3.5.
Ustawienia przedstawione są na poniższym obrazku:

​
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:

Niektóre przykłady kodu są następujące:

​
CURL

curl -X POST 'https://api.acedata.cloud/localization/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
  "locale": "zh-CN",
  "extension": "md"
}'

​
Python

import requests

url = "https://api.acedata.cloud/localization/translate"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
    "locale": "zh-CN",
    "extension": "md"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
Przykład odpowiedzi

Po pomyślnym wykonaniu żądania API zwróci informacje o wynikach tego zadania tłumaczenia. Na przykład: 
{
  "data": "# 标题 1\n\n这是一个段落。\n\n## 标题 2\n\n这是另一个段落。",
  "usage": {
    "prompt_tokens": 172,
    "completion_tokens": 25
  },
  "model": "gpt-3.5-turbo-16k",
  "locale": "zh-CN"
}
Można zauważyć, że w wyniku znajduje się pole 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 autoryzacyjny.
  • 429 too_many_requests: Zbyt wiele żądań, przekroczono limit.
  • 500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

​
Przykład odpowiedzi błędu

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Wnioski

Dzięki temu dokumentowi zrozumiałeś, jak używać API Tłumaczenia Lokalizacji, aby łatwo przetłumaczyć wprowadzony tekst na określony język, a także wspierać określone metody wyjścia wyników tłumaczenia. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.