Registrer deg som utvikler og få en API-nøkkel
Tilbyr RESTful APIer for dokumentoversettelse, med støtte for automatisert håndtering av oversettelsesoppgaver, ordliste-basert terminologikonsistens, og spørringer for støttede formater, språk og modeller, noe som gjør det enkelt å bygge sømløse oversettelsesarbeidsflyter og administrere brukerkontoer.
Kom i gang
For å komme i gang, må du søke om å bli utvikler.Søk som utvikler
Når det er godkjent, kan du opprette flere API-nøkler og inkludere den aktuelle API-nøkkelen i hver API-forespørsel etter behov.
Rask tilkobling
Base URL
https://shangyiai.com/api
Autentiseringsmetode
Authorization: [yourSecretKey]
JSON forespørsel
Bortsett fra filopplastingsgrensesnittet, bruker grensesnitt som standard POST JSON-forespørsler, Content-Type er application/json.
Filopplasting
Opprettelse av dokumentoversettelsesoppgave bruker multipart/form-data, file-feltet overfører filen som skal oversettes.
Generell feilrespons
Når forespørselen mislykkes vil grensesnittet returnere JSON, error-feltet inneholder en fast engelsk feilmelding. Det anbefales å prioritere feilhåndtering etter HTTP status code, error-feltet brukes til visning eller loggføring.
{
"error": "Invalid API key."
}Feilstatuskoderegler
Alle v1 API-feilresponser har samme struktur, håndter dem etter følgende HTTP-statuskoderegler.
- 400 Bad Request
- Manglende obligatoriske parametere, ugyldige parameterformater eller enum-verdier, manglende filopplasting, feil ved lagring av opplasting, eller oppgavebehandlingsfeil.
- 401 Unauthorized
- Manglende API-nøkkel eller ugyldig API-nøkkel.
- 402 Payment Required
- Utilstrekkelig kredittsaldo for forhåndsvisning, full oversettelse eller tekstoversettelse.
- 404 Not Found
- Oppgaven eller ordlisten eksisterer ikke, har blitt slettet, tilhører ikke den nåværende API-kontoen, eller ble ikke opprettet gjennom API-et.
- 409 Conflict
- Den nåværende oppgavestatusen tillater ikke den forespurte operasjonen.
- 500 Internal Server Error
- Uventet serverunntak. Svarfeilen er fiksert som "Intern serverfeil.".
Anbefalt integrasjonsprosess
1. Opprett oppgave
Last opp fil og opprett oversettelsesoppgave, returnerer taskId.
2. Spør om fremdrift
Spør etter oppgavestatus til den er Completed, Terminated eller Cancelled.
3. Hent resultat
Last ned oversatt fil, eller les kildetekst og oversettelse som JSON.
4. Administrer oppgaver
Betal etter behov for fulltekstoversettelse, omstart av oppgaver, tekstrevisjon eller sletting av oppgaver.