URL Dasar API Mimo dan Cara Mengonfigurasi Klien

Nilai yang harus disalin

Siapa pun yang mencari url dasar api mimo membutuhkan tiga nilai, dan sisanya adalah detail alat yang Anda konfigurasikan.

Pengaturan	Nilai
URL dasar	https://api.mimoapi.top/v1
ID model	uncensored
Header Auth	Authorization: Bearer YOUR_KEY
Endpoint chat	POST /v1/chat/completions
Daftar model	GET /v1/models

Layanan ini kompatibel dengan OpenAI, sehingga klien apa pun yang memungkinkan Anda mengubah URL dasar dan kunci OpenAI akan berfungsi. Ini adalah API teks yang di-hosting yang menjalankan satu model bobot terbuka dari penyedia independen; ini bukan API resmi dari vendor model mana pun. Hanya teks: tidak ada generasi gambar, audio, atau video, tidak ada embedding, dan tidak ada fine-tuning, sehingga klien yang mengharapkan endpoint tersebut tidak akan menemukannya. Jika Anda belum memiliki kunci, halaman kunci hanya butuh satu menit.

URL dasar versus endpoint lengkap

Kesalahan paling umum adalah antara URL dasar dan URL endpoint. URL dasar berhenti di /v1. Endpoint adalah dasar ditambah jalur. SDK OpenAI resmi, dan sebagian besar alat yang dibangun di atasnya, menggabungkan keduanya untuk Anda.

• URL Dasar: https://api.mimoapi.top/v1
• Endpoint Obrolan: https://api.mimoapi.top/v1/chat/completions
• Endpoint Model: https://api.mimoapi.top/v1/models

Ketika layar pengaturan meminta "URL dasar", "API dasar", "endpoint" atau "host", baca placeholder-nya. Jika placeholder berakhir dengan /v1, tempel URL dasar. Jika berakhir dengan /chat/completions, tempel endpoint obrolan lengkap. Menempel endpoint lengkap ke bidang yang mengharapkan dasar menghasilkan /chat/completions/chat/completions, yang tidak ada. Menempel domain telanjang ke bidang yang mengharapkan dasar menghasilkan /chat/completions tanpa /v1, yang gagal dengan cara yang sama.

Perhatikan juga host-nya. API berada di subdomain api. Domain situs web biasa melayani halaman web, sehingga permintaan ke domain tersebut dengan jalur API tidak akan mencapai model.

Python dan Node

Dengan SDK resmi, Anda mengatur URL dasar sekali saat membuat klien. Instal dengan pip install openai atau npm install openai.

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.mimoapi.top/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Name three uses for a base URL."}],
    max_tokens=150,
)
print(resp.choices[0].message.content)

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.mimoapi.top/v1",
  apiKey: process.env.LLM_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Name three uses for a base URL." }],
  max_tokens: 150,
});
console.log(resp.choices[0].message.content);

SDK OpenAI Python dan Node juga membaca variabel lingkungan OPENAI_BASE_URL dan OPENAI_API_KEY ketika Anda tidak meneruskan nilai dalam kode. Itu memungkinkan Anda mengarahkan ulang skrip yang ada tanpa mengeditnya: ekspor dua variabel, dan skrip berbicara ke API ini. Periksa bahwa skrip tidak mengunci model seperti nama GPT; ganti dengan uncensored.

curl untuk pengujian cepat

Pemanggilan HTTP biasa menghilangkan setiap variabel lain, sehingga ini adalah pemeriksaan pertama terbaik. Perintah pertama mencantumkan model dan mengonfirmasi kunci. Yang kedua mengirim permintaan obrolan.

Copyexport LLM_API_KEY="YOUR_KEY"

curl -s https://api.mimoapi.top/v1/models \
  -H "Authorization: Bearer $LLM_API_KEY"

curl -s https://api.mimoapi.top/v1/chat/completions \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":20}' -i

Bendera -i mencetak header respons. Cari X-Request-Id (salin jika Anda menghubungi dukungan), X-Balance-USD (sisa saldo Anda) dan dua header batas laju, X-RateLimit-Limit-Requests dan X-RateLimit-Limit-Concurrency. Untuk streaming, tambahkan "stream": true ke badan permintaan dan -N ke curl agar output tidak di-buffer. panduan cepat lima menit akan menelusuri streaming dan pemanggilan alat setelah ini.

LangChain, antarmuka obrolan, dan alat lainnya

Alat pihak ketiga menggunakan label mereka sendiri, tetapi semuanya membutuhkan tiga nilai yang sama. Beberapa pola yang akan Anda lihat:

• LangChain (Python): ChatOpenAI(model="uncensored", base_url="https://api.mimoapi.top/v1", api_key="YOUR_KEY"). Kelas yang sama berfungsi untuk server kompatibel OpenAI apa pun.
• SillyTavern dan antarmuka roleplay serupa: pilih sumber obrolan kompatibel OpenAI kustom atau generik, tempel URL dasar, tambahkan kunci, dan ketik uncensored sebagai nama model jika daftar tidak terisi sendiri.
• Open WebUI dan antarmuka obrolan hosting mandiri lainnya: tambahkan koneksi yang kompatibel dengan OpenAI di pengaturan, menggunakan URL dasar dan kunci yang sama.
• Plugin editor dan skrip: cari "endpoint OpenAI kustom" atau "ganti URL dasar" di pengaturan plugin.

Nama menu setiap alat berubah antar-versi, sehingga andalkan tujuan bidang daripada label yang tepat. Jika alat bersikeras memeriksa kunci terhadap penyedia tetap, itu tidak kompatibel dengan endpoint kustom, dan alat lain adalah perbaikannya.

Ketika alat menawarkan dropdown model, biasanya mengisinya dengan memanggil GET /v1/models. Jika dropdown tetap kosong, ketik ID model secara manual. Jika alat menolak nama model yang tidak dikenal, cari opsi yang diberi label "model kustom".

Memperbaiki kesalahan konfigurasi umum

Ketika permintaan gagal, kode status dan URL yang tepat mempersempit penyebabnya dengan cepat. Kerjakan daftar ini.

1. Kesalahan autentikasi. Kunci hilang, terpotong, atau memiliki spasi atau baris baru di akhir. Tempel lagi, dan pastikan header berbunyi Bearer, spasi, lalu kunci.
2. Tidak ditemukan. Jalurnya salah. Cetak URL akhir yang dibangun klien Anda. Itu harus persis https://api.mimoapi.top/v1/chat/completions. Cari /v1 yang hilang, jalur ganda atau host yang salah.
3. Model tidak dikenal. Nama model sisa dari penyedia lain. Atur model menjadi uncensored.
4. HTTP 429 dengan rate_limited atau concurrency. Anda melebihi 300 permintaan per menit atau 8 sekaligus (60 dan 2 pada kunci uji coba). Perlambat atau antrekan permintaan. Header Retry-After: 5 pada 429 berarti kelebihan beban sementara; tunggu lima detik dan coba lagi.
5. Permintaan terlalu besar. Batas ukuran body adalah 8 MB, dan jendela konteks adalah 100.000 token untuk prompt plus penyelesaian. Potong riwayat.
6. Berfungsi di curl, gagal di browser. Memanggil API langsung dari JavaScript front-end mengekspos kunci Anda ke setiap pengunjung. Arahkan panggilan melalui server Anda sendiri.

Jangan pernah menempatkan kunci di repositori publik atau bundel sisi klien. Simpan dalam variabel lingkungan, dan simpan jauh dari tangkapan layar dan tiket dukungan.

Langkah selanjutnya setelah panggilan sukses pertama

Setelah URL dasar berfungsi, beberapa pengaturan layak diketahui. Streaming di atas SSE diaktifkan dengan stream: true. Pemanggilan alat menggunakan tools dan tool_choice, dengan hasil dikirim kembali sebagai pesan role: "tool". Mode JSON adalah response_format: {"type": "json_object"}. Kontrol sampling seperti temperature, top_p, stop, seed dan penalti diteruskan.

Di sisi biaya, Anda membayar $0,15 per 1M token input dan $0,50 per 1M token output dari saldo prabayar; halaman harga mencantumkan ukuran isi saldo dan bonus. Model ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, dan konten seksual yang melibatkan anak di bawah umur tidak pernah diizinkan. Prompt tidak digunakan untuk pelatihan.

Panduan lainnya

• Harga API Mimo: Tarif Bayar Per Token Prabayar
• Kunci API Mimo: Buat Satu dan Buat Permintaan
• Alternatif API Mistral: Membandingkan Opsi LLM Tanpa Sensor