Pengenalan Konfigurasi Model
Tutorial ini menjelaskan cara mengkonfigurasi berbagai model bahasa besar di SelectTranslate ekstensi, termasuk API keys, URL titik akhir, pemilihan model, parameter kinerja, dan pengaturan perintah. Konfigurasi model yang tepat dapat meningkatkan stabilitas layanan dan meningkatkan akurasi terjemahan, kecepatan respons, dan pengalaman pengguna secara keseluruhan di berbagai skenario terjemahan.
1. Konfigurasi API Key
Sebuah API key adalah kredensial akses resmi yang diberikan oleh penyedia layanan model, yang digunakan untuk menghubunginya dengan aman AI model dan layanan terkait.
Umum API Key Masalah Konfigurasi
- Salah API Key Format: Itu API key mungkin ada karakter yang hilang, spasi tambahan, atau salah terpotong. Pastikan untuk menyalin kunci lengkap yang disediakan oleh layanan dan hindari menyertakan spasi, jeda baris, atau karakter tidak valid lainnya.
- API Key Ketidakcocokan dengan Penyedia Layanan: API keys dari penyedia model yang berbeda tidak dapat dipertukarkan. Misalnya, sebuah OpenAI API key tidak dapat digunakan dengan DeepSeek model.
- API Key Kedaluwarsa atau Dinonaktifkan: Milik Anda API key mungkin telah dicabut karena kedaluwarsa, penonaktifan manual, masalah akun, batas penggunaan, atau alasan keamanan. Silakan kunjungi konsol penyedia Anda untuk memverifikasi status Anda saat ini API key.
- Kesalahan URL Titik Akhir: Bahkan dengan valid API Key, pengujian koneksi mungkin gagal jika URL titik akhir salah, jalur versi tidak ada, atau tidak cocok dengan persyaratan spesifik penyedia.
- Ketidakcocokan Nama Model: Pastikan nama model dieja dengan benar dan didukung secara resmi oleh penyedia Anda. Kesalahan ketik di sini sering kali salah diidentifikasi sebagai API Key masalah.
- Masalah Jaringan atau Proksi: Stabilitas jaringan lokal, konfigurasi proksi, atau pembatasan firewall dapat memblokir permintaan, sehingga mengakibatkan kegagalan autentikasi atau batas waktu permintaan.
2. Pemilihan Model Penerjemahan
Saat mengonfigurasi ekstensi, nama model harus cocok dengan penyedia layanan yang terkait dengan API key; jika tidak, model tersebut tidak dapat dipanggil dengan sukses.
Penyedia yang Didukung dan Pemetaan Model
| Penyedia | Nama Model |
|---|---|
| OpenAI | gpt-5、gpt-5-mini、gpt-5-nano |
| Gemini | gemini-2.5-flash、gemini-2.0-flash-lite |
3. Adat API URL
Ekstensi menggunakan yang resmi API URL secara default, jadi biasanya tidak diperlukan penyesuaian. Entri URL secara manual hanya diperlukan dalam kasus berikut:
- Memanggil model melalui proxy terbalik atau layanan relai,
- Menggunakan layanan model besar yang diterapkan secara pribadi,
- Menghubungkan ke pihak ketiga API layanan yang tidak sepenuhnya menggunakan URL default resmi.
Pedoman Masukan：
- URL harus berupa endpoint HTTPS yang lengkap, misalnya：
https://api.your-company.com/v1/chat/completions - Jalur titik akhir harus sesuai dengan dokumentasi teknis penyedia layanan, dan API harus menerima dan menangani permintaan yang mengikuti format yang ditentukan dengan benar.
4. Penyetelan Parameter Model
Parameter berikut digunakan untuk menyesuaikan kualitas terjemahan, stabilitas model, dan kecepatan respons. Pengaturan default mencakup sebagian besar kasus penggunaan; sesuaikan sesuai kebutuhan untuk kebutuhan spesifik.
| Parameter | Deskripsi | Pengaturan yang Direkomendasikan |
|---|---|---|
| Panjang teks maksimum per permintaan | Digunakan untuk membatasi jumlah maksimum karakter yang dapat dikirimkan dalam satu permintaan terjemahan. Menetapkan nilai ini terlalu tinggi dapat memperlambat kecepatan API tanggapan; menjaganya dalam kisaran yang wajar membantu meningkatkan stabilitas dan kecepatan respons. | - Direkomendasikan 1000–1500 karakter- Hindari melebihi 2000 karakter untuk mencegah penundaan respons atau hilangnya konten. |
| Jumlah maksimum paragraf per permintaan | Jumlah paragraf yang dapat dikirimkan sekaligus dalam satu permintaan terjemahan. Mengirimkan terlalu banyak paragraf sekaligus dapat meningkatkan beban pemrosesan, sehingga memperlambat respons atau mengurangi stabilitas. Menetapkan nilai ini dengan tepat akan membantu meningkatkan efisiensi dan keandalan terjemahan secara keseluruhan. | - Teks Teknis atau Hukum:1(proses paragraf demi paragraf untuk memastikan keakuratan terminologi)- Novel, Dialog, atau Blog: 3–5(meningkatkan kelancaran) |
| Permintaan maksimum per detik | Jumlah permintaan terjemahan yang dikirim per detik. Jika tingkat permintaan terlalu tinggi, permintaan tambahan akan dimasukkan ke dalam antrean untuk menghindari tercapainya permintaan API batas kecepatan dan untuk menjaga stabilitas sistem secara keseluruhan. | - Penggunaan Umum:25- Layanan dengan Tarif Terbatas yang Ketat (misalnya, Gemini): 8–10 |
| Suhu | Mengontrol keacakan dan variabilitas keluaran model. Nilai suhu yang lebih tinggi menghasilkan respons yang lebih beragam dan kreatif, sedangkan nilai yang lebih rendah menghasilkan keluaran yang lebih stabil, yang lebih disukai untuk terjemahan yang konsisten dan akurat. | - Rekomendasi untuk tugas penerjemahan: Suhu resmi yang direkomendasikan bervariasi menurut model. Disarankan untuk menggunakan default yang disediakan dan sesuaikan sesuai kebutuhan. |
5. Perintah Kustom (Prompt Sistem/Prompt Pengguna)
Ekstensi ini mencakup perintah terjemahan umum bawaan yang dioptimalkan yang mencakup sebagian besar skenario terjemahan umum. Jika ada persyaratan khusus—seperti gaya terjemahan, konsistensi terminologi, keahlian domain, atau preferensi nada—perintah khusus dapat digunakan untuk menyempurnakan keluaran model.
Saat membuat perintah terjemahan khusus, disarankan untuk mengikuti panduan berikut:
- Instruksi yang jelas dan spesifik: Tentukan dengan jelas bahasa target, gaya terjemahan, domain, dan ekspresi atau pilihan kata apa pun yang harus dihindari.
- Instruksi yang dapat ditindaklanjuti: Gunakan deskripsi yang konkrit dan tepat, hindari pernyataan yang tidak jelas atau abstrak, untuk memastikan model dapat memahami dan mengikuti instruksi secara akurat.
- Jaga agar perintah tetap ringkas: Pastikan perintah memberikan informasi yang cukup namun tetap singkat, menghindari detail yang berlebihan yang dapat mengganggu pemahaman model.
6. Penafian
🔔 Harap perhatikan tingkat gratis dan biaya apa pun yang dibebankan oleh penyedia layanan untuk menghindari biaya tak terduga.