Direktori dokumen

API Tugasan Terjemahan

Terjemah teks

POST/v1/translation/translateTexts

Terjemah teks dan kembalikan hasil terjemahan secara serentak.

Alamat lengkap
https://otranslator.com/api/v1/translation/translateTexts
Pengesahan
Perlu memasukkan API Key dalam pengepala permintaan Authorization
Content-Type
application/json
Format salah
{ "error": "Invalid API key." }

Perkara Perhatian

API ini akan menyimpan teks yang dimasukkan buat sementara sebagai dokumen JSON dan memproses secara serentak, sesuai untuk terjemahan segera teks berskala kecil.

Baki kredit akaun perlu sekurang-kurangnya 2 credits. Jika kos sebenar melebihi baki, interface akan mengembalikan taskId dan price, serta memaklumkan baki tidak mencukupi.

Contoh

curl
1curl -X POST 'https://otranslator.com/api/v1/translation/translateTexts' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5  "texts": [
6    "string"
7  ],
8  "fromLang": "[string]",
9  "toLang": "[string]"
10}'

Parameter Permintaan

ParameterJenisLalaiKeteranganContoh
*textsString[]-

Teks yang perlu diterjemahkan

-
*fromLangString-
  • Bahasa asal, bahasa asal tidak boleh sama dengan bahasa sasaran
  • Bahasa yang disokong: pertanyaan
-
*toLangString-
  • Bahasa sasaran, bahasa sasaran tidak boleh sama dengan bahasa asal
  • Bahasa yang disokong: pertanyaan
-
modelString-
  • Model AI untuk terjemahan
  • Model yang disokong: pertanyaan
-
fileDescriptionString-

Penerangan dokumen, meningkatkan kualiti terjemahan dengan menyediakan maklumat tambahan, contohnya menambah maklumat latar belakang dokumen tambahan dan keperluan terjemahan lain

-

Respons

ParameterJenisLalaiKeteranganContoh
taskIdString-

ID Tugasan

-
translatedTextsString[]-

Teks yang telah diterjemahkan

-
priceInteger-

Jumlah Credits yang diperlukan untuk keseluruhan terjemahan

-
usedCreditsInteger-

Bilangan Credits yang telah digunakan untuk tugas terjemahan

-

Ralat Biasa

401 Missing API key.

The Authorization request header is required.

401 Invalid API key.

The API key does not exist, has been deleted, or is no longer valid.

402 Insufficient credits balance.

The account does not have enough credits to translate the texts.

400 Missing required parameter: fromLang.

Provide fromLang using a language returned by /api/v1/languages.

400 Missing required parameter: toLang.

Provide toLang using a language returned by /api/v1/languages.

400 Missing required parameter: texts.

Provide a non-empty texts array.

400 Failed to translate texts.

The text translation task could not be processed.

API Tugasan Terjemahan
Mulakan semula tugasan terjemahan