Vai al contenuto principale
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, dopo essere entrati nella pagina, clicca sul pulsante “Acquire”, come mostrato nell’immagine: Pagina di richiesta Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login 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

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)

​
Esempio di risposta

Dopo una richiesta riuscita, l’API restituirà le informazioni sui risultati di questo compito di traduzione. Ad esempio: 
{
  "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

{
  "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.