Hoppa till huvudinnehåll
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 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 Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan 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:

​
Kodexempel

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

Några kodexempel är som följer:

​
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)

​
Svarsexempel

När begäran lyckas kommer API:et att returnera resultatinformationen för denna översättningsuppgift. Till exempel: 
{
  "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

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