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, börja med att gå till Ace Data Cloud-konsolen för att få din API-token, som du kan spara för framtida bruk. Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan för att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. En API-token räcker för att anropa alla tjänster på plattformen, du behöver inte ansöka separat för varje tjänst. Första ansökan ger en gratis kvot, så att du kan prova gratis; när kvoten är slut kan du ladda på allmän balans i konsolen.
📘 Fullständig dokumentation: Lokalisering Översätt API →

​
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., och vi visar hur man laddar upp den engelska beskrivningen och får den kinesiska översättningen, samtidigt som vi presenterar den 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: innehållet som behöver översättas. Vid extension=md skickas en sträng, vid extension=json skickas ett JSON-objekt.
  • locale: anpassa det översatta språket.
  • extension: formatet för inmatat innehåll, valfritt md eller json.
  • model: den stora modellen som används för översättning, standard är gpt-3.5.
extension måste matcha input-typen; strängar kan inte använda json, JSON-objekt kan inte använda md. Ställ in som visas i bilden nedan:

​
Kodexempel

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

Några kodexempel är som följer:

​
CURL

​
Python

​
Svarsexempel

Vid en lyckad begäran kommer API:et att returnera resultatinformationen för denna översättningsuppgift. Till exempel:
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, typen 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: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 401 invalid_token: Obefogad, 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

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