> ## 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.
# Integrazione e utilizzo dell'API di traduzione Localization
> Localization translation 集成指南 - XHuoAPI
La principale funzionalità dell'API di traduzione Localization è quella di ottenere il testo tradotto inserendo il testo da tradurre, mentre la lingua di traduzione può essere personalizzata e i risultati della traduzione possono essere restituiti in due formati principali: `json` e `markdown`.
Questo documento fornirà una descrizione dettagliata dell'integrazione dell'API di traduzione, aiutandoti a integrare facilmente e sfruttare appieno le potenti funzionalità di questa API. Attraverso l'API di traduzione, puoi facilmente tradurre il testo inserito in una lingua specifica e supportare modalità specifiche per restituire i risultati della traduzione.
## Processo di richiesta
Per utilizzare l'API di traduzione Localization, è necessario prima richiedere il servizio appropriato nella pagina di richiesta [API di traduzione Localization](https://api.xhuoapi.ai/documents/6dcc60d0-a973-4ad2-92d8-11f4d3775532), dopo essere entrati nella pagina, clicca sul pulsante "Acquire", come mostrato nell'immagine:
Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla [pagina di login](https://api.xhuoapi.ai) che ti invita a registrarti e accedere; dopo aver effettuato il login o la registrazione, verrai automaticamente riportato alla pagina corrente.
Alla prima richiesta, verrà fornito un credito gratuito, che ti consente di utilizzare gratuitamente questa API.
## Esempio di richiesta
Prendiamo un esempio di input in inglese per dimostrare come utilizzare questa API. Supponiamo che la descrizione in inglese sia: `# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.`, ora dimostriamo come caricare la descrizione in inglese e ottenere il risultato della traduzione in cinese, presentandolo in formato markdown.
### Impostazione dell'intestazione della richiesta e del corpo della richiesta
**Request Headers** includono:
* `accept`: specifica di ricevere la risposta in formato JSON, qui si compila con `application/json`.
* `authorization`: la chiave per chiamare l'API, che può essere selezionata direttamente dopo la richiesta.
**Request Body** include:
* `input`: il testo da tradurre.
* `locale`: la lingua di traduzione personalizzata.
* `extension`: il formato di visualizzazione del risultato della traduzione.
* `model`: il modello di traduzione utilizzato, il predefinito è gpt-3.5.
Impostato come mostrato nell'immagine seguente:
### Esempio di codice
Si può notare che sul lato destro della pagina sono già stati generati automaticamente vari codici in diverse lingue, come mostrato nell'immagine:
Alcuni esempi di codice sono i seguenti:
#### 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)
```
### Esempio di risposta
Dopo una richiesta riuscita, l'API restituirà le informazioni sui risultati di questo compito di traduzione. Ad esempio:
```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"
}
```
Si può notare che nel risultato c'è un campo `data`, che contiene il testo tradotto in cinese, restituendolo anche in formato markdown, le altre informazioni sono le seguenti:
* `data`, il risultato di questo compito di traduzione.
* `model`, il modello di linguaggio utilizzato per questo compito di traduzione.
* `locale`, il tipo di lingua di traduzione per questo compito di traduzione.
## Gestione degli errori
Quando si chiama l'API, se si verifica un errore, l'API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:
* `400 token_mismatched`: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
* `400 api_not_implemented`: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
* `401 invalid_token`: Non autorizzato, token di autorizzazione non valido o mancante.
* `429 too_many_requests`: Troppe richieste, hai superato il limite di frequenza.
* `500 api_error`: Errore interno del server, qualcosa è andato storto sul server.
### Esempio di risposta di errore
```json theme={null}
{
"success": false,
"error": {
"code": "api_error",
"message": "fetch failed"
},
"trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
```
## Conclusione
Attraverso questo documento, hai appreso come utilizzare l'API di traduzione Localization per tradurre facilmente il testo inserito in una lingua specifica e supportare modalità specifiche per restituire i risultati della traduzione. Speriamo che questo documento ti aiuti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.