Skip to main content
Lokalisering Översätt API:s huvudfunktion är att få översatt text genom att mata in text som behöver översättas, samtidigt som det översatta språket kan anpassas, 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 saldo 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: 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 på bilden:

Några kodexempel är som följer:

CURL

Python

Svarsexempel

När begäran lyckas 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: 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

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.