Lewati ke konten

Terjemahan instan

POST /api/v1/ai/translate-snippet
{
"text": "Hello world",
"source_lang": "auto",
"target_lang": "zh",
"engine": "xr-397b"
}

text berisi 1–5000 karakter. target_lang dan source_lang (selain auto) harus berupa kode bahasa yang didukung; jika tidak, gunakan 422. Tanggapan:

{ "translated_text": "你好,世界", "source_lang": "auto", "target_lang": "zh" }
POST /api/v1/ai/translate-batch
{
"segments": [
{ "id": "p1", "text": "First paragraph." },
{ "id": "p2", "text": "Second paragraph." }
],
"target_lang": "zh"
}
  • segments berisi 1–64 segmen dengan masing-masing maksimal 4000 karakter; setiap id bersifat unik dalam permintaan (1–64 karakter). Terlalu banyak segmen atau segmen yang terlalu panjang akan menghasilkan kesalahan 413.
  • Respons mengembalikan segments: [{ "id", "translated_text" }] sesuai urutan permintaan.
  • Segmen yang hanya berisi spasi dikembalikan apa adanya dan tidak dikenakan biaya.
  • Badan permintaan dibatasi hingga 2 MB dan sebuah permintaan berjalan paling lama 180 detik; atur batas waktu klien setidaknya menjadi 180 detik.
  • Kirim Idempotency-Key. Setelah terjadi gangguan jaringan atau timeout, coba lagi dengan kunci yang sama dan body yang sama; Anda tidak akan dikenakan biaya dua kali.
  • engine yang tidak tersedia mengembalikan 400; jika kunci tersebut memiliki pengaturan yang diizinkan yang tidak mencakup pilihan yang dipilih, 403.
  • Dihitung berdasarkan jumlah teks sumber yang benar-benar diproses.
POST /api/v1/ai/ocr

Unggah gambar ke bidang file pada multipart/form-data (PNG, JPEG, WebP, BMP, GIF, hingga 12 MB dan 25 juta piksel), atau kirim gambar sebagai badan permintaan. Respons memberikan teks baris demi baris beserta koordinat piksel:

{
"width": 640,
"height": 240,
"engine": "omnidoc-ocr",
"blocks": [
{ "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 }
]
}
  • x dan y adalah sudut kiri atas dari baris teks, dalam koordinat gambar yang diunggah (sebuah JPEG dengan data orientasi dibaca dalam posisi tegak).
  • Satu kotak per baris; confidence adalah kepercayaan pengenalan untuk baris tersebut (0–1). Jika tidak ditemukan teks, responsnya adalah 200 dengan blocks kosong.
  • Pengenalan teks gambar tidak dikenakan biaya kredit. Gambar dengan lebar atau panjang kurang dari 11 piksel akan menghasilkan hasil kosong.
  • Jika pengenalan sementara tidak tersedia, responsnya adalah 503; jika timeout, responsnya adalah 504, dengan penjelasan dalam bahasa Mandarin di detail; silakan coba lagi nanti.
  • Masuk (omnidoc.translate.use), kunci API, dan masuk melalui peramban pada ekstensi terjemahan web semuanya dapat memanggilnya.
  • Parameter kueri engine, scene, dan lang dipertahankan untuk versi ekstensi yang lebih lama dan tidak memengaruhi hasil.
  • Untuk mendapatkan gambar yang diterjemahkan secara langsung, unggah gambar tersebut dan buat pekerjaan terjemahan . .

POST /api/v1/ai/notes, /ai/chat, dan /ai/generate telah dihentikan dan mengembalikan 410.