Terjemahan instan
Terjemahan teks singkat
Section titled “Terjemahan teks singkat”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" }Penerjemahan segmen batch
Section titled “Penerjemahan segmen batch”POST /api/v1/ai/translate-batch{ "segments": [ { "id": "p1", "text": "First paragraph." }, { "id": "p2", "text": "Second paragraph." } ], "target_lang": "zh"}segmentsberisi 1–64 segmen dengan masing-masing maksimal 4000 karakter; setiapidbersifat unik dalam permintaan (1–64 karakter). Terlalu banyak segmen atau segmen yang terlalu panjang akan menghasilkan kesalahan413.- Respons mengembalikan
segments: [{ "id", "translated_text" }]sesuai urutan permintaan. - Segmen yang hanya berisi spasi dikembalikan apa adanya dan tidak dikenakan biaya.
Konvensi
Section titled “Konvensi”- 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. engineyang tidak tersedia mengembalikan400; jika kunci tersebut memiliki pengaturan yang diizinkan yang tidak mencakup pilihan yang dipilih,403.- Dihitung berdasarkan jumlah teks sumber yang benar-benar diproses.
Pengenalan teks gambar
Section titled “Pengenalan teks gambar”POST /api/v1/ai/ocrUnggah 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 } ]}xdanyadalah sudut kiri atas dari baris teks, dalam koordinat gambar yang diunggah (sebuah JPEG dengan data orientasi dibaca dalam posisi tegak).- Satu kotak per baris;
confidenceadalah kepercayaan pengenalan untuk baris tersebut (0–1). Jika tidak ditemukan teks, responsnya adalah200denganblockskosong. - 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 adalah504, dengan penjelasan dalam bahasa Mandarin didetail; 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, danlangdipertahankan untuk versi ekstensi yang lebih lama dan tidak memengaruhi hasil. - Untuk mendapatkan gambar yang diterjemahkan secara langsung, unggah gambar tersebut dan buat pekerjaan terjemahan . .
Titik akhir yang sudah pensiun
Section titled “Titik akhir yang sudah pensiun”POST /api/v1/ai/notes, /ai/chat, dan /ai/generate telah dihentikan dan mengembalikan 410.