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

# Lokalisering Översätt API:s integration och användning

> Localization translation 集成指南 - XHuoAPI

Lokalisering Översätt API:s huvudfunktion är att få översatt text genom att mata in text som behöver översättas, samtidigt som det går att anpassa det översatta språket, och översättningsresultatet kan presenteras i antingen `json` eller `markdown` format.

Detta dokument kommer att detaljerat beskriva integrationsanvisningarna för Översätt API, för att hjälpa dig att enkelt integrera och fullt utnyttja API:ets kraftfulla funktioner. Genom Översätt API kan du enkelt översätta inmatad text till ett specifikt språk och stödja specifika sätt att presentera översättningsresultatet.

## Ansökningsprocess

För att använda Lokalisering Översätt API, behöver du först gå till ansökningssidan [Lokalisering Översätt API](https://api.xhuoapi.ai/documents/6dcc60d0-a973-4ad2-92d8-11f4d3775532) för att ansöka om motsvarande tjänst. När du kommer till sidan, klicka på "Acquire"-knappen, som visas i bilden nedan:

![Ansökningssidan](https://cdn.xhuoapi.ai/rci31i.png)

Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till [inloggningssidan](https://api.xhuoapi.ai) där du uppmanas att registrera dig och logga in. Efter inloggning eller registrering kommer du automatiskt att återvända till den aktuella sidan.

Vid första ansökan kommer det att finnas en gratis kvot som ges, så att du kan använda API:et gratis.

## Begärningsexempel

Vi tar ett engelskt inmatningsexempel för att demonstrera hur man använder API:et. Anta att den engelska beskrivningen är: `# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.`, nedan visas hur man laddar upp den engelska beskrivningen och får den kinesiska översättningen, samtidigt som den presenteras i markdown-format.

### Ställ in begärningshuvuden och begärningskropp

**Begärningshuvuden** inkluderar:

* `accept`: specificera att du tar emot svar i JSON-format, här anges som `application/json`.
* `authorization`: nyckeln för att anropa API:et, som kan väljas direkt efter ansökan.

**Begärningskropp** inkluderar:

* `input`: den text som ska översättas.
* `locale`: anpassa det översatta språket.
* `extension`: anpassa formatet för att visa översättningsresultatet.
* `model`: den stora modellen som används för översättning, standard är gpt-3.5.

Inställningarna visas som på bilden nedan:

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

### Kodexempel

Det kan noteras att olika språkversioner av koden redan har genererats automatiskt på höger sida, som visas i bilden nedan:

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

Några kodexempel är som följer:

#### CURL

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/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.xhuoapi.ai/v1/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)
```

### Svarsexempel

När begäran lyckas kommer API:et att returnera resultatinformationen för denna översättningsuppgift. Till exempel:

```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"
}
```

Det kan ses att resultatet innehåller ett `data`-fält, som innehåller den översatta kinesiska texten, och som returneras i markdown-format. Övrig information är som följer:

* `data`, resultatet av denna översättningsuppgift.
* `model`, den stora språkmodellen som används för denna översättningsuppgift.
* `locale`, typ av översättningsspråk för denna översättningsuppgift.

## Felhantering

Vid anrop av API:et, om ett fel uppstår, kommer API:et att returnera motsvarande felkod och information. Till exempel:

* `400 token_mismatched`: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar.
* `400 api_not_implemented`: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar.
* `401 invalid_token`: Obehörig, ogiltig eller saknad auktoriseringstoken.
* `429 too_many_requests`: För många begärningar, du har överskridit hastighetsgränsen.
* `500 api_error`: Intern serverfel, något gick fel på servern.

### Felrespons exempel

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

## Slutsats

Genom detta dokument har du fått en förståelse för hur du använder Lokalisering Översätt API för att enkelt översätta inmatad text till ett specifikt språk och stödja specifika sätt att presentera översättningsresultatet. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.