> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Integracja i użycie API Tłumaczenia Lokalizacji

> Localization translation API guide - Ace Data Cloud

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](https://platform.acedata.cloud/documents/localization-translate), aby ubiegać się o odpowiednią usługę. Po wejściu na stronę kliknij przycisk „Acquire”, jak pokazano na obrazku:

![Strona aplikacji](https://cdn.acedata.cloud/rci31i.png)

Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na [stronę logowania](https://platform.acedata.cloud), 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:

<p>
  <img src="https://cdn.acedata.cloud/d4uqst.png" width="500" className="m-auto" />
</p>

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

<p>
  <img src="https://cdn.acedata.cloud/tn5nno.png" width="500" className="m-auto" />
</p>

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

#### CURL

```bash theme={null}
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

```python theme={null}
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:

```json theme={null}
{
  "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

```json theme={null}
{
  "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.