> ## 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 Midjourney Translate

> Midjourney generation 集成指南 - XHuoAPI

La principale funzionalità dell'API Midjourney Translate è quella di ottenere una descrizione in inglese a partire da una descrizione in cinese fornita come contenuto.

Questo documento fornirà una dettagliata spiegazione dell'integrazione dell'API Midjourney Translate, aiutandovi a integrare facilmente e sfruttare appieno le potenti funzionalità di questa API. Con l'API Midjourney Translate, potete facilmente convertire descrizioni in cinese in descrizioni in inglese.

## Processo di richiesta

Per utilizzare l'API Midjourney Translate, è necessario prima andare alla pagina di richiesta [Midjourney Translate API](https://api.xhuoapi.ai/documents/e067d19b-7a66-4458-a45f-0fe88c1d5d34) per richiedere il servizio corrispondente. Una volta entrati nella pagina, cliccate sul pulsante "Acquire", come mostrato nell'immagine:

![Pagina di richiesta](https://cdn.xhuoapi.ai/rci31i.png)

Se non siete ancora registrati o loggati, sarete automaticamente reindirizzati alla [pagina di login](https://api.xhuoapi.ai) che vi inviterà a registrarvi e a loggarvi. Dopo aver effettuato il login o la registrazione, sarete automaticamente riportati alla pagina corrente.

Alla prima richiesta, verrà offerto un credito gratuito, che consente di utilizzare l'API senza costi.

## Esempio di richiesta

Prendiamo come esempio una descrizione in cinese e dimostriamo come utilizzare l'API. Supponiamo che la descrizione in cinese sia: "精致，无暇，洁白的天使", e ora dimostriamo come caricare la descrizione in cinese e ottenere la descrizione in inglese.

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

* `content`: la descrizione in cinese da caricare.

> Solo questo campo è necessario per completare la traduzione, assicuratevi che `content` utilizzi la descrizione in cinese.

Impostato come mostrato nell'immagine seguente:

![](https://cdn.xhuoapi.ai/db8lrn.png)

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

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

Alcuni esempi di codice sono i seguenti:

#### CURL

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/midjourney/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "content": "精致，无暇，洁白的天使"
}'
```

#### Python

```python theme={null}
import requests

url = "https://api.xhuoapi.ai/v1/midjourney/translate"

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

payload = {
    "content": "精致，无暇，洁白的天使"
}

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

### Esempio di risposta

Dopo una richiesta riuscita, l'API restituirà una descrizione tradotta della descrizione in cinese. Ad esempio:

```json theme={null}
{
  "content": "Exquisite, flawless, pure white angel"
}
```

Si può notare che nel risultato c'è un campo `content`, che contiene la descrizione tradotta in inglese, corrispondente alla traduzione della descrizione in cinese.

* `content`, genera la corrispondente descrizione in inglese, utilizzabile per compiti di generazione di immagini.

## 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, avete superato il limite di frequenza.
* `500 api_error`: Errore interno del server, qualcosa è andato storto sul server.

### Esempio di risposta di errore

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

## Conclusione

Attraverso questo documento, avete appreso come utilizzare l'API Midjourney Translate per tradurre le descrizioni in cinese caricate in descrizioni in inglese. Speriamo che questo documento possa aiutarvi a integrare e utilizzare meglio questa API. Se avete domande, non esitate a contattare il nostro team di supporto tecnico.