kimiapikey.comPanduan
URL Dasar API Moonshot: Arahkan Kode Anda Ke Tempat Lain
URL dasar API Moonshot hanyalah satu string di klien gaya OpenAI Anda, dan mengubahnya adalah cara Anda mengarahkan kode yang sama ke penyedia yang berbeda. Halaman ini menunjukkan di mana string tersebut berada di Python, Node, curl, dan alat umum, serta cara mengarahkannya ke endpoint alternatif.
Diperbarui


Poin utama
- URL dasar adalah satu pengaturan; body permintaan tetap dalam format chat OpenAI.
- Ubah tiga hal saat Anda beralih: URL dasar, kunci API, ID model.
- Endpoint kami adalah https://api.kimiapikey.com/v1 dan ID model adalah uncensored.
- Ini adalah model yang di-host secara independen, bukan layanan resmi Moonshot, jadi uji ulang prompt Anda.
Apa sebenarnya yang dilakukan URL dasar
Klien yang kompatibel dengan OpenAI membangun setiap permintaan dari dua bagian: URL dasar dan jalur URL. SDK menggabungkannya, sehingga panggilan ke chat.completions.create menjadi POST ke <base_url>/chat/completions. Penyedia yang mengikuti format ini, termasuk Moonshot, menerbitkan URL dasar mereka sendiri di dokumentasi mereka. Carilah di sana daripada menyalinnya dari posting forum, karena itu adalah satu nilai yang tidak bisa Anda tebak.
Beralih penyedia karena itu memerlukan tiga pengeditan dan tidak ada yang lain:
- URL dasar, yang menentukan ke mana permintaan dikirim.
- Kunci API, yang dikeluarkan per penyedia dan hanya berfungsi di server penyedia tersebut.
- ID model, karena setiap penyedia menamai model mereka dengan cara yang berbeda.
Pesan, peran, streaming, alat, dan mode JSON tetap memiliki bentuk yang sama, itulah mengapa proses migrasinya singkat. Apa pun yang bergantung pada fitur spesifik penyedia, seperti alat pencarian web bawaan, akan memerlukan penanganan terpisah.
Ini juga membantu untuk menyimpan tiga nilai bersama-sama dalam satu blok konfigurasi atau satu file lingkungan per penyedia. Ketika URL dasar, kunci, dan ID model berdampingan, beralih kembali adalah perubahan satu baris, dan Anda menghindari keadaan migrasi parsial di mana kunci baru dipasangkan dengan alamat lama.
Python: paket openai
Di Python, Anda mengatur URL dasar saat membuat klien. Contoh ini berkomunikasi dengan endpoint di situs ini:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
Jika Anda lebih suka menjaga kode bebas dari pengaturan, gunakan variabel lingkungan. SDK membaca OPENAI_BASE_URL dan OPENAI_API_KEY saat Anda memanggil OpenAI() tanpa argumen, sehingga deployment dapat beralih penyedia tanpa perubahan kode. Sadari bahwa ini juga berarti variabel sisa di shell Anda dapat menimpa nilai yang Anda tulis di file.
Node dan curl
Paket JavaScript resmi menggunakan nama opsi yang sama, ditulis dalam camel case:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.kimiapikey.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
Tanpa SDK sama sekali, URL dasar hanyalah bagian depan alamat:
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
Endpoint yang sama juga menerima POST /v1/responses, dan GET /v1/models mencantumkan sumber daya yang dilayaninya. Autentikasi adalah token bearer di header Authorization dalam setiap kasus.
Editor dan antarmuka chat
Alat GUI menampilkan URL dasar di bawah label berbeda: "API base", "Override OpenAI Base URL", "Custom endpoint" atau "Provider URL". Nilai yang Anda tempel adalah string yang sama seperti dalam kode di atas, berakhir di /v1. Jangan tempel alamat lengkap /chat/completions kecuali alat tersebut memerlukan URL lengkap.
Setelah menyimpan, tambahkan ID model secara manual jika alat tidak mengambil daftar. Beberapa editor memvalidasi kunci terhadap penyedia tetap dan menolak nilai kustom, dalam hal ini carilah pengaturan yang mengaktifkan mode kustom atau kompatibel OpenAI terlebih dahulu. Artikel tentang menggunakan kunci API gaya Kimi di Cursor menjelaskan secara rinci salah satu alat seperti itu.
Apa yang berubah saat Anda menukar penyedia
Format yang cocok tidak berarti perilaku yang cocok. Sebelum Anda memindahkan lalu lintas produksi, periksa poin-poin ini satu per satu:
- Gaya output. Model yang berbeda menulis dengan cara yang berbeda. Jalankan prompt asli Anda, bukan contoh mainan.
- Ukuran konteks. Endpoint di sini memiliki jendela konteks 100.000 token untuk prompt plus penyelesaian. Jika pengaturan Anda saat ini mengirim prompt yang lebih panjang, pangkas terlebih dahulu.
- Batas. Kunci penuh memungkinkan 8 permintaan konkuren dan 300 per menit. Melebihi salah satu batas akan menghasilkan HTTP 429, dengan
rate_limitedatauconcurrencysebagai kode. - Fitur. Streaming melalui SSE, pemanggilan fungsi dan mode JSON didukung. Pembuatan gambar, audio dan video, embedding, dan fine-tuning tidak didukung; ini adalah API teks saja.
- Penamaan. Layanan menjalankan satu model bobot terbuka yang dipilih untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan API resmi Moonshot dan bukan router antar vendor.
Cara netral untuk membandingkan adalah dengan mencatat sepuluh prompt yang sama melalui kedua endpoint tersebut dan membaca jawabannya secara berdampingan. Hal ini memakan waktu beberapa menit dan mengurangi tebakan.
Kesalahan URL dasar dan tampilannya
Kebanyakan kegagalan setelah beralih berasal dari alamat, bukan kunci. Berikut adalah bagaimana setiap kesalahan muncul dan cara memperbaikinya.
| Kesalahan | Gejala | Perbaikan |
|---|---|---|
Host saja, tanpa /v1 | 404 pada setiap panggilan | Tambahkan /v1 ke akhir |
| Jalur lengkap yang ditempelkan | 404 dengan jalur ganda di kesalahan | Potong alamat kembali ke /v1 |
| Garis miring akhir plus penggabungan jalur secara manual | Garis miring ganda di URL | Biarkan SDK menggabungkan jalur |
| Kunci lama, URL baru | 401 | Gunakan kunci yang dikeluarkan oleh penyedia baru |
| URL lama, kunci baru | 401 dari penyedia lama | Cari repositori dan shell untuk alamat lama |
http:// alih-alih https:// | Error redirect atau koneksi | Gunakan https di mana-mana |
Cara cepat untuk menemukan sisaan adalah dengan mencari proyek dan pengaturan deployment Anda untuk nama host lama. Lihat di file .env, variabel CI, file docker compose, dan pengaturan editor apa pun, karena satu salinan yang terlupakan sudah cukup untuk mengirim beberapa lalu lintas ke penyedia lama.
Streaming dan alat setelah beralih
Atur stream: true dan balasan tiba sebagai server-sent events, dengan penggunaan token dilaporkan di akhir. Pemanggilan alat menggunakan bidang tools dan tool_choice yang biasa, streaming tool_calls dan hasil dikirim kembali sebagai pesan dengan role: "tool". Jika kode Anda sudah menangani ini untuk penyedia lama, itu harus terus berfungsi; konfirmasi dengan menjalankan satu panggilan streaming dan satu panggilan alat sebelum Anda beralih sepenuhnya. Ingat bahwa permintaan streaming memegang slot konkurensinya hingga stream berakhir.
Pemeriksaan biaya sebelum beralih
Penagihan di sini dihitung per token: $0,15 per 1 juta token input dan $0,50 per 1 juta token output, dari saldo prabayar, tanpa langganan. Permintaan yang gagal atau ditolak tidak dikenakan biaya, dan saldo tidak kedaluwarsa. Untuk tarif penyedia lain, lihat halaman harga terbaru mereka, karena itu berubah.
Contoh yang dikerjakan. Misalkan permintaan memiliki 2.000 token input dan 500 token output:
- Input: 2.000 / 1.000.000 x $0,15 = $0,0003
- Output: 500 / 1.000.000 x $0,50 = $0,00025
- Total: $0,00055 per permintaan, jadi 1.000 permintaan biaya $0,55
Top-up terkecil adalah $20, dan yang lebih besar menambahkan bonus: +5% dari $50, +10% dari $100 dan +15% dari $200. Kripto (USDT di TRC20, USDC di Base) diterima. Detail lengkap ada di halaman harga, dan rincian fokus Kimi ada di harga kunci API Kimi.
Dapatkan kunci dan jalankan panggilan pertama
Daftar dengan Google atau dengan email dan kata sandi, lalu buka halaman kunci API. Pengguna baru dapat mengklaim kredit uji coba senilai $0,50 di sana dengan satu klik, satu per orang, berlaku selama 7 hari dan tanpa perlu kartu. Kunci uji coba dibatasi hingga 2 permintaan paralel dan 60 per menit, yang sudah cukup untuk menjalankan pengujian.
Tempelkan kunci tersebut ke cuplikan kode Python di atas, jalankan, dan konfirmasi bahwa Anda menerima teks sebagai balasan. dokumentasi mencantumkan setiap parameter, dan header respons X-Request-Id serta X-Balance-USD membantu dalam pemecahan masalah dan pelacakan saldo. Prompt yang dikirim ke layanan tidak digunakan untuk pelatihan.
Panduan lainnya
- Kunci API Kimi Tidak Berfungsi: Penyebab, Perbaikan, Fallback
- Gunakan Kunci API Gaya Kimi di Cursor: Panduan Pengaturan
Pertanyaan yang Sering Diajukan
Apakah modelnya sama dengan Kimi resmi dari Moonshot?
Tidak, kami menjalankan model bobot terbuka yang telah disesuaikan agar tanpa sensor. Ini bukan GPT, Claude, Gemini, Grok, DeepSeek, atau model dari vendor lain. Ini adalah model unik yang dijalankan di server kami sendiri.
Apakah Anda melatih model dengan data saya?
Tidak. Prompt dan completion Anda tidak digunakan untuk pelatihan. Kami menghargai privasi dan transparansi, sehingga data Anda tetap menjadi milik Anda.
Berapa batas laju-nya?
Anda dibatasi hingga 300 permintaan per menit per kunci. Ukuran badan permintaan maksimum adalah 8 MB. Batas-batas ini dirancang untuk memastikan kinerja stabil bagi semua pengguna.
Apa kebijakan konten-nya?
Model ini tanpa sensor untuk topik dewasa, kontroversial, dan kreatif. Namun, kami memblokir konten seksual yang melibatkan anak di bawah umur. Ini adalah batas keras yang selalu berlaku, terlepas dari tingkat langganan Anda.
Tanya jawab
Apakah saya perlu mengubah kode saya saat mengubah base URL?
Biasanya hanya ada tiga nilai: URL dasar, kunci API, dan ID model. Format pesan, streaming, dan pemanggilan alat tetap sama selama penyedia baru mendukungnya.
Haruskah URL dasar diakhiri dengan /v1?
Ya untuk endpoint ini: https://api.kimiapikey.com/v1. SDK menambahkan /chat/completions sendiri, jadi jangan sertakan.
Apakah ini API resmi Moonshot?
Tidak. Ini adalah model bobot terbuka yang di-host secara independen di balik API yang kompatibel dengan OpenAI. Ini bukan layanan Moonshot dan bukan router lintas vendor.
Di mana saya menemukan ID model?
Panggil GET /v1/models dengan kunci Anda. Pada endpoint ini, ID model adalah uncensored.
Kunci Anda hanya perlu mengisi satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh pengaturannya.