one api

Bahasa Inggris |

Digunakan ke Zeabur

Server Zeabur ada di luar negeri, yang secara otomatis memecahkan masalah jaringan, dan jumlah bebasnya cukup untuk penggunaan pribadi.

1. Pertama, bayangkan salinan kode.
2. Pergi ke Zeabur, masuk, dan masukkan konsol.
3. Buat proyek baru, pilih Marketplace di Layanan -> Tambah Layanan, Pilih MySQL, dan Catat Parameter Koneksi (Nama Pengguna, Kata Sandi, Alamat, Port).
4. Salin parameter tautan dan jalankan Buat Database create database `one-api` .
5. Kemudian di Layanan -> Tambah Layanan, pilih Git (Otorisasi diperlukan untuk penggunaan pertama), dan pilih Repositori Fork Anda.
6. Deploy akan mulai secara otomatis dan membatalkan terlebih dahulu. Buka variabel di bawah ini, tambahkan PORT dengan nilai 3000 , tambahkan SQL_DSN dengan nilai <username>:<password>@tcp(<addr>:<port>)/one-api , dan simpan. Perhatikan bahwa jika SQL_DSN tidak diisi, data tidak akan bertahan dan data akan hilang setelah pemindahan.
7. Pilih Redeploy.
8. Pergi ke domain di bawah ini dan pilih awalan nama domain yang sesuai, seperti "my-one-api", dan nama domain terakhir adalah "my-one-api.zeabur.app", atau Anda dapat menggunakan nama domain Anda sendiri.
9. Tunggu penempatan selesai, klik nama domain yang dihasilkan untuk memasukkan One API.

Digunakan untuk merender

Render memberikan batas kredit gratis, yang selanjutnya dapat meningkatkan batas kredit setelah mengikat kartu.

Render dapat secara langsung menggunakan gambar Docker tanpa perlu repositori Fork: https://dashboard.render.com

Konfigurasi

Sistem itu sendiri berada di luar kotak.

Anda dapat mengonfigurasinya dengan mengatur variabel lingkungan atau parameter baris perintah.

Setelah sistem dimulai, gunakan pengguna root untuk masuk ke sistem dan membuat konfigurasi lebih lanjut.

Catatan : Jika Anda tidak tahu arti item konfigurasi, Anda dapat menghapus nilainya sementara untuk melihat teks prompt lebih lanjut.

Cara menggunakan

Tambahkan tombol API Anda ke halaman渠道, dan kemudian tambahkan token akses baru ke halaman令牌.

Kemudian Anda dapat menggunakan token Anda untuk mengakses API satu, yang sama dengan API OpenAI.

Anda perlu mengatur basis API sebagai alamat penyebaran API Anda di berbagai tempat di mana OpenAI API digunakan, misalnya: https://openai.justsong.cn , dan kunci API adalah token yang Anda hasilkan dalam satu API.

Perhatikan bahwa format basis API spesifik tergantung pada klien yang Anda gunakan.

Misalnya, Perpustakaan Resmi Openai:

OPENAI_API_KEY= " sk-xxxxxx "
OPENAI_API_BASE= " https://<HOST>:<PORT>/v1 " 

 grafik lr
    A (pengguna)
    A ---> | Permintaan dengan kunci yang didistribusikan oleh satu API | B (satu API)
    B -> | Permintaan Relay | C (OpenAi)
    B -> | Permintaan Relay | D (Azure)
    B -> | Permintaan Relay | E (Saluran Hilir Lainnya dari Format API OpenAI)
    B-> | Relay dan Ubah Badan Permintaan dan Badan Kembali | F (Saluran Hilir dalam Format API Non-Openai)

Anda dapat menentukan saluran mana yang akan digunakan untuk menangani permintaan ini dengan menambahkan ID saluran setelah token, misalnya: Authorization: Bearer ONE_API_KEY-CHANNEL_ID . Perhatikan bahwa token yang dibuat oleh pengguna administrator harus diminta untuk menentukan ID saluran.

Jika tidak ditambahkan, beberapa saluran akan digunakan dalam penyeimbangan beban.

Variabel Lingkungan

One API mendukung variabel lingkungan membaca .env .env.example .env .

1. REDIS_CONN_STRING : Redis akan digunakan sebagai cache setelah pengaturan.
   • Contoh: REDIS_CONN_STRING=redis://default:redispw@localhost:49153
   • Jika latensi akses basis data sangat rendah, tidak perlu mengaktifkan REDIS, dan lag data akan terjadi setelah mengaktifkannya.
2. SESSION_SECRET : Setelah pengaturan, kunci sesi tetap akan digunakan, sehingga cookie pengguna yang masuk masih akan valid setelah sistem restart.
   • Contoh: SESSION_SECRET=random_string
3. SQL_DSN : Basis data yang ditentukan akan digunakan sebagai ganti SQLite setelah pengaturan, gunakan MySQL atau PostgreSQL.
   • contoh:
     • Mysql: SQL_DSN=root:123456@tcp(localhost:3306)/oneapi
     • Postgresql: SQL_DSN=postgres://postgres:123456@localhost:5432/oneapi (adaptasi, umpan balik diterima)
   • Perhatikan bahwa Anda perlu membuat database oneapi terlebih dahulu.
   • Jika menggunakan database lokal: perintah penempatan dapat ditambahkan --network="host" sehingga program dalam wadah dapat mengakses MySQL pada host.
   • Jika menggunakan database cloud: Jika server cloud perlu memverifikasi identitas, Anda perlu menambahkan ?tls=skip-verify dalam parameter koneksi.
   • Harap ubah parameter berikut sesuai dengan konfigurasi database Anda (atau pertahankan nilai default):
     • SQL_MAX_IDLE_CONNS : Jumlah maksimum koneksi idle, default adalah 100 .
     • SQL_MAX_OPEN_CONNS : Jumlah maksimum koneksi terbuka, default adalah 1000 .
       • Jika kesalahan Error 1040: Too many connections , harap kurangi nilainya dengan tepat.
     • SQL_CONN_MAX_LIFETIME : siklus hidup maksimum koneksi, default adalah 60 , dalam hitungan menit.
4. LOG_SQL_DSN : Setelah pengaturan, database terpisah akan digunakan untuk tabel logs .
5. FRONTEND_BASE_URL : Setelah pengaturan, permintaan halaman pengalihan akan diminta ke alamat yang ditentukan, hanya dari pengaturan server.
   • Contoh: FRONTEND_BASE_URL=https://openai.justsong.cn
6. MEMORY_CACHE_ENABLED : Aktifkan true memori false menyebabkan keterlambatan tertentu false memperbarui kuota pengguna.
   • Contoh: MEMORY_CACHE_ENABLED=true
7. SYNC_FREQUENCY : Frekuensi konfigurasi yang disinkronkan dengan database dengan cache diaktifkan, dalam detik, default adalah 600 detik.
   • Contoh: SYNC_FREQUENCY=60
8. NODE_TYPE : Setelah pengaturan, tipe node slave master master
   • Contoh: NODE_TYPE=slave
9. CHANNEL_UPDATE_FREQUENCY : Setelah pengaturan, saldo saluran akan diperbarui secara berkala, dalam hitungan menit, dan jika tidak diatur, itu tidak akan diperbarui.
   • Contoh: CHANNEL_UPDATE_FREQUENCY=1440
10. CHANNEL_TEST_FREQUENCY : Setelah pengaturan, saluran akan diperiksa secara teratur, unitnya adalah menit, dan jika tidak diatur, inspeksi tidak akan dilakukan. +Contoh: CHANNEL_TEST_FREQUENCY=1440
11. POLLING_INTERVAL : Interval permintaan ketika Batch Update Saluran Saldo dan ketersediaan pengujian, dalam hitungan detik, tanpa interval secara default.
    • Contoh: POLLING_INTERVAL=5
12. BATCH_UPDATE_ENABLED : Aktifkan agregasi pembaruan batch basis false true yang false menyebabkan keterlambatan tertentu dalam pembaruan kuota pengguna.
    • Contoh: BATCH_UPDATE_ENABLED=true
    • Jika Anda memiliki terlalu banyak koneksi basis data, Anda dapat mencoba mengaktifkan opsi ini.
13. BATCH_UPDATE_INTERVAL=5 : Interval waktu untuk pembaruan batch agregat, dalam detik, default adalah 5 .
    • Contoh: BATCH_UPDATE_INTERVAL=5
14. Batas frekuensi meminta:
    • GLOBAL_API_RATE_LIMIT : Batas tarif API global (kecuali permintaan relai), jumlah maksimum permintaan dalam waktu tiga menit dari satu IP tunggal, default adalah 180 .
    • GLOBAL_WEB_RATE_LIMIT : Batas tarif web global, jumlah maksimum permintaan dalam waktu tiga menit dari satu IP tunggal, default adalah 60 .
15. Pengaturan cache encoder:
    • TIKTOKEN_CACHE_DIR : Program dimulai, beberapa pengkodean kata umum akan diunduh secara online, seperti: gpt-3.5-turbo .
    • DATA_GYM_CACHE_DIR : Saat ini, fungsi konfigurasi ini konsisten dengan TIKTOKEN_CACHE_DIR , tetapi prioritasnya tidak setinggi itu.
16. RELAY_TIMEOUT : Pengaturan batas waktu relay diatur dalam detik, dan waktu batas waktu tidak diatur secara default.
17. RELAY_PROXY : Gunakan proxy ini untuk meminta API setelah pengaturan.
18. USER_CONTENT_REQUEST_TIMEOUT : Batas waktu untuk mengunduh konten yang diunggah oleh pengguna, dalam hitungan detik.
19. USER_CONTENT_REQUEST_PROXY : Setelah pengaturan, gunakan proxy ini untuk meminta konten yang diunggah oleh pengguna, seperti gambar.
20. SQLITE_BUSY_TIMEOUT : SQLite Lock menunggu pengaturan batas waktu, unit adalah milidetik, default adalah 3000 .
21. GEMINI_SAFETY_SETTING : Pengaturan keamanan Gemini, BLOCK_NONE default.
22. GEMINI_VERSION : Versi Gemini yang digunakan oleh satu API, default ke v1 .
23. THEME : Pengaturan tema sistem, default adalah default , silakan merujuk ke nilai opsional tertentu di sini.
24. ENABLE_METRIC : Apakah akan menonaktifkan saluran sesuai dengan tingkat keberhasilan permintaan, itu tidak diaktifkan secara default, dan nilai -nilai opsionalnya true dan false .
25. METRIC_QUEUE_SIZE : Ukuran antrian statistik tingkat keberhasilan permintaan, default adalah 10 .
26. METRIC_SUCCESS_RATE_THRESHOLD : Ambang batas tingkat keberhasilan permintaan adalah 0.8 secara default.
27. INITIAL_ROOT_TOKEN : Jika nilai ini diatur, token pengguna root dengan nilai variabel lingkungan akan secara otomatis dibuat ketika sistem pertama kali di -boot.
28. INITIAL_ROOT_ACCESS_TOKEN : Jika nilai ini ditetapkan, token manajemen sistem secara otomatis dibuat ketika sistem pertama kali dimulai.
29. ENFORCE_INCLUDE_USAGE : Apakah akan memaksa penggunaan untuk kembali dalam model aliran, itu tidak diaktifkan secara default, nilai opsional true dan false .

Parameter baris perintah

1. --port <port_number> : Menentukan nomor port yang didengarkan server, standarnya adalah 3000 .
   • Contoh: --port 3000
2. --log-dir <log_dir> : Tentukan folder logs .
   • Contoh: --log-dir ./logs
3. --version : Cetak nomor versi sistem dan keluar.
4. --help : Periksa bantuan penggunaan perintah dan deskripsi parameter.

Demo

Demo online

Perhatikan bahwa situs demonstrasi ini tidak menyediakan layanan eksternal: https://openai.justsong.cn

Tampilan tangkapan layar

Pertanyaan yang sering diajukan

1. Apa batas kreditnya? Bagaimana cara menghitungnya? Apakah ada masalah dengan perhitungan kuota satu API?
   • Kredit = Pembesaran Pengelompokan* Perbesaran Model* (Tip Token Nomor + Nomor Token Lengkap* Pembesaran Penyelesaian)
   • Rasio penyelesaian ditetapkan menjadi 1,33 untuk GPT3.5 dan 2 untuk GPT4, yang konsisten dengan pejabat.
   • Jika ini adalah mode non-aliran, antarmuka resmi akan mengembalikan token total yang dikonsumsi, tetapi Anda harus memperhatikan berbagai tingkat konsumsi permintaan dan penyelesaian.
   • Perhatikan bahwa pembesaran default dari satu API adalah perbesaran resmi, yang telah disesuaikan.
2. Mengapa kuota akun tidak mencukupi?
   • Silakan periksa apakah batas token Anda cukup, ini terpisah dari batas akun.
   • Batas token hanya untuk pengguna untuk mengatur penggunaan maksimum, dan pengguna dapat mengaturnya dengan bebas.
3. Tip: Tidak ada saluran yang tersedia?
   • Silakan periksa Pengaturan Pengelompokan Pengguna dan Pengelompokan Saluran.
   • dan pengaturan model saluran.
4. Kesalahan Uji Saluran: invalid character '<' looking for beginning of value
   • Ini karena nilai pengembalian bukan JSON yang sah, tetapi halaman HTML.
   • Sangat mungkin bahwa simpul IP atau proxy dari situs penyebaran Anda telah dilarang oleh CloudFlare.
5. Chatgpt Kesalahan Web Berikutnya: Failed to fetch
   • Jangan atur BASE_URL saat digunakan.
   • Periksa apakah alamat antarmuka dan kunci API Anda diisi dengan benar.
   • Periksa apakah HTTPS diaktifkan, dan browser akan mencegat permintaan HTTP dengan nama domain HTTPS.
6. Kesalahan:当前分组负载已饱和，请稍后再试
   • Saluran hulu 429.
7. Apakah data saya akan hilang setelah meningkatkan?
   • Jika menggunakan MySQL, itu tidak akan.
   • Jika menggunakan SQLite, Anda perlu memasang file database One-API.DB yang bertahan sesuai dengan perintah penempatan yang saya berikan, jika tidak data akan hilang setelah wadah dimulai kembali.
8. Apakah saya perlu melakukan perubahan pada database sebelum meningkatkan?
   • Secara umum, tidak perlu, dan sistem akan secara otomatis menyesuaikannya selama inisialisasi.
   • Jika perlu, saya akan menjelaskannya di log pembaruan dan memberikan skrip.
9. Kesalahan dilaporkan setelah secara manual memodifikasi database:数据库一致性已被破坏，请联系管理员?
   • Ini adalah ID saluran yang mendeteksi bahwa beberapa catatan dalam tabel kemampuan tidak ada.
   • Untuk setiap saluran, model yang didukung perlu memiliki catatan tabel kemampuan khusus yang menunjukkan bahwa saluran mendukung model.

Proyek terkait

• Fastgpt: Sistem Tanya Jawab Basis Pengetahuan Berdasarkan Model Bahasa LLM Besar
• CHATGPT Web Berikutnya: Miliki aplikasi cross-platform crossform Anda sendiri dengan satu klik
• VCHART: Tidak hanya itu perpustakaan grafik multi-end di luar kotak, tetapi juga pendongeng data yang jelas dan fleksibel.
• VMIND: Tidak hanya otomatis, itu juga sangat pintar. Solusi visualisasi cerdas sumber terbuka.

Melihat

Proyek ini adalah open source menggunakan protokol MIT. Jika Anda tidak ingin mempertahankan atribusi, Anda harus terlebih dahulu mendapatkan otorisasi.

Ini juga berlaku untuk proyek departemen kedua berdasarkan proyek ini.

Menurut Perjanjian MIT, pengguna harus menanggung risiko dan tanggung jawab menggunakan proyek ini dengan biaya mereka sendiri, dan pengembang proyek open source ini tidak ada hubungannya dengan ini.