Integracja i użycie API Tłumaczenia Lokalizacji

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 popularnych 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, 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. Pierwszy wniosek daje darmowy limit, aby móc skorzystać z doświadczenia; w przypadku niewystarczającego limitu można 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 brzmi: # 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 to zaprezentować 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 złożeniu wniosku można go bezpośrednio wybrać z rozwijanej listy.

Ciało żądania obejmuje:

input: treść do przetłumaczenia. Przy extension=md przekaż ciąg, przy extension=json przekaż obiekt JSON.
locale: dostosowany język tłumaczenia.
extension: format wprowadzonej treści, opcjonalnie md lub json.
model: duży model używany do tłumaczenia, domyślnie to gpt-3.5.

`extension`	Typ `input`	Przykład
`md`	string	`"# Title\n\nParagraph"`
`json`	object	`{"title": "Hello", "button": "Submit"}`

extension musi odpowiadać typowi input; ciąg nie może być używany z json, obiekt JSON nie może być używany z md. Ustawienia jak 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 żądaniu 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 odpowiedni kod błędu 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.

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 przypadku jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Coding

Więcej przewodników

Integracja i użycie API Tłumaczenia Lokalizacji

Proces aplikacji

Przykład żądania

Ustawienie nagłówków żądania i ciała żądania

Przykład kodu

CURL

Python

Przykład odpowiedzi

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski

​Proces aplikacji

​Przykład żądania

​Ustawienie nagłówków żądania i ciała żądania

​Przykład kodu

​CURL

​Python

​Przykład odpowiedzi

​Obsługa błędów

​Przykład odpowiedzi błędu

​Wnioski

Proces aplikacji

Przykład żądania

Ustawienie nagłówków żądania i ciała żądania

Przykład kodu

CURL

Python

Przykład odpowiedzi

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski