Mimo API Base URL ve İstemcilerin Yapılandırılması

Kopyalanacak değerler

mimo api temel url arayanların üç değere ihtiyacı vardır, geri kalanı yapılandırdığınız aracın detaylarıdır.

Ayar	Değer
Temel URL	https://api.mimoapi.top/v1
Model kimliği	uncensored
Kimlik doğrulama başlığı	Authorization: Bearer YOUR_KEY
Sohbet uç noktası	POST /v1/chat/completions
Model listesi	GET /v1/models

Hizmet OpenAI ile uyumlu olduğundan, OpenAI temel URL'sini ve anahtarını değiştirmenize olanak tanıyan herhangi bir istemci çalışır. Bağımsız bir sağlayıcı tarafından işletilen açık ağırlıklı bir model üzerinden çalışan barındırılmış bir metin API'sidir; herhangi bir model satıcısının resmi API'si değildir. Yalnızca metin: görsel, ses veya video üretimi, embedding'ler ve ince ayar (fine-tuning) yoktur; bu uç noktalara bekleyen istemciler bunları bulamayacaktır. Henüz anahtarınız yoksa anahtar sayfası dakikanızı alır.

Temel URL ile tam uç nokta arasındaki fark

En yaygın kafa karışıklığı temel URL ile uç nokta URL'si arasındadır. Temel URL /v1'de sona erer. Uç nokta, temel URL'ye bir yol eklenmiş halidir. Resmi OpenAI SDK'ları ve bunlar üzerine kurulu çoğu araç, ikisini sizin için birleştirir.

• Temel URL: https://api.mimoapi.top/v1
• Sohbet uç noktası: https://api.mimoapi.top/v1/chat/completions
• Modeller uç noktası: https://api.mimoapi.top/v1/models

Bir ayar ekranı "temel URL", "API temeli", "uç nokta" veya "ana makine" isterse, yer tutucuyu okuyun. Yer tutucu /v1 ile bitiyorsa temel URL'yi yapıştırın. /chat/completions ile bitiyorsa tam sohbet uç noktasını yapıştırın. Tam uç noktanın temel URL bekleyen bir alana yapıştırılması /chat/completions/chat/completions üretir, bu mevcut değildir. Yalnızca alan adının temel URL bekleyen bir alana yapıştırılması /chat/completions üretir, /v1 olmadan; bu da aynı şekilde başarısız olur.

Ana makineyi de not edin. API api alt alan adında bulunur. Düz site alan adı web sayfalarını sunar, bu yüzden API yoluyla yapılan bir istek modele ulaşmaz.

Python ve Node

Resmi SDK'larla temel URL'yi istemci oluştururken bir kez ayarlarsınız. pip install openai veya npm install openai ile yükleyin.

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);

Python ve Node OpenAI SDK'ları ayrıca kodda değerler geçmediğinizde OPENAI_BASE_URL ve OPENAI_API_KEY ortam değişkenlerini okur. Bu, mevcut bir betiği düzenlemeden yeniden yönlendirmeyi mümkün kılar: iki değişkeni dışa aktarın ve betik bu API ile iletişim kurar. Betiğin GPT adı gibi bir modeli sabit kodlayıp kodlamadığını kontrol edin; onu uncensored ile değiştirin.

Hızlı bir test için curl

Saf bir HTTP çağrısı diğer tüm değişkenleri ortadan kaldırır, bu yüzden en iyi ilk kontroldür. İlk komut modelleri listeler ve anahtarı doğrular. İkinci sohbet isteği gönderir.

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

-i bayrağı yanıt başlıklarını yazdırır. X-Request-Id'yi (destekle iletişime geçerseniz belirtin), X-Balance-USD (kalan krediniz) ve iki hız limiti başlığını, X-RateLimit-Limit-Requests ve X-RateLimit-Limit-Concurrency'i arayın. Akış için gövdeye "stream": true ekleyin ve çıktı tamponlanmasın diye curl'a -N ekleyin. beş dakikalık hızlı başlangıç akış ve fonksiyon çağırma konularını bu işlemden sonra anlatır.

LangChain, sohbet arayüzleri ve diğer araçlar

Üçüncü taraf araçlar kendi etiketlerini kullanır, ancak hepsi aynı üç değere ihtiyaç duyar. Göreceğiniz bazı kalıplar:

• LangChain (Python): ChatOpenAI(model="uncensored", base_url="https://api.mimoapi.top/v1", api_key="YOUR_KEY"). Aynı sınıf herhangi bir OpenAI uyumlu sunucu için çalışır.
• SillyTavern ve benzeri rol yapma arayüzleri: özel veya genel bir OpenAI uyumlu sohbet kaynağı seçin, temel URL'yi yapıştırın, anahtarı ekleyin ve liste kendisi dolmuyorsa model adı olarak uncensored yazın.
• Open WebUI ve diğer kendi kendine barındırılan sohbet UI'ları: ayarlarda aynı temel URL ve anahtarı kullanarak bir OpenAI uyumlu bağlantı ekleyin.
• Editör eklentileri ve betikler: eklenti ayarlarında "özel OpenAI uç noktası" veya "temel URL'yi geçersiz kıl" arayın.

Her aracın menü adları sürümler arasında değişir, bu yüzden kesin etiketten ziyade alanın amacına güvenin. Bir araç anahtarı sabit bir sağlayıcıya karşı kontrol etmekte ısrar ederse, özel uç noktalarla uyumlu değildir ve farklı bir araç çözümdür.

Bir araç bir model açılır menüsü sunduğunda, genellikle GET /v1/models çağırarak onu doldurur. Açılır menü boş kalırsa model kimliğini elle yazın. Araç bilinmeyen model adlarını reddederse, "özel model" etiketli bir seçenek arayın.

Yaygın yapılandırma hatalarının giderilmesi

Bir istek başarısız olduğunda, durum kodu ve tam URL nedeni hızla daraltır. Bu listeyi aşağı doğru işleyin.

1. Kimlik doğrulama hatası. Anahtar eksik, kesilmiş veya sonunda boşluk veya yeni satır içeriyor. Tekrar yapıştırın ve başlığın Bearer, bir boşluk ve ardından anahtar olarak okunduğundan emin olun.
2. Bulunamadı. Yol yanlış. İstemcinizin oluşturduğu son URL'yi yazdırın. Tam olarak https://api.mimoapi.top/v1/chat/completions olmalıdır. Eksik /v1, yinelenen yol veya yanlış ana makine arayın.
3. Bilinmeyen model. Başka bir sağlayıcıdan kalan bir model adı. Modeli uncensored olarak ayarlayın.
4. rate_limited veya concurrency ile HTTP 429. Dakikada 300 istekten veya aynı anda 8 istekten fazlasını yapıyorsunuz (deneme sürümü anahtarında 60 ve 2). Daha yavaş çalışın veya istekleri kuyruğa alın. Retry-After: 5 başlığı içeren bir 429 geçici aşırı yüklenmeyi gösterir; beş saniye bekleyin ve yeniden deneyin.
5. İstek çok büyük. Gövde sınırı 8 MB'dir ve bağlam penceresi istem ve tamamlama için 100.000 token'dır. Geçmişi kısaltın.
6. curl'da çalışır, tarayıcıda başarısız olur. API'yi doğrudan ön uç JavaScript'ten çağırmak anahtarınızı her ziyaretçiye açığa çıkarır. Çağrıları kendi sunucunuz üzerinden yönlendirin.

Anahtarı herkese açık bir depoda veya istemci paketinde kullanmayın. Bir ortam değişkeninde saklayın ve ekran görüntülerinden ve destek taleplerinden uzak tutun.

İlk başarılı çağrıdan sonraki adımlar

Temel URL çalıştıktan sonra, bilinmesi değerli birkaç ayar vardır. SSE üzerinden akış stream: true ile açılır. Fonksiyon çağırma tools ve tool_choice kullanır; sonuçlar role: "tool" mesajları olarak gönderilir. JSON modu response_format: {"type": "json_object"} şeklindedir. temperature, top_p, stop, seed gibi örnekleme kontrolleri ve cezalar iletilir.

Ödeme tarafında, ön ödemeli krediden 1M girdi token başına $0.15 ve 1M çıktı token başına $0.50 ödersiniz; fiyatlandırma sayfası bakiye yükleme boyutlarını ve bonusları listeler. Model, yasal yetişkin kullanımında içerik reddetmeleri olmadan yanıt verecek şekilde ayarlanmıştır ve reşit olmayanların yer aldığı cinsel içerik asla kabul edilmez. İstemler eğitim için kullanılmaz.

Daha fazla kılavuz

• Mimo API Fiyatlandırması: Ön Ödemeli Token Başına Oranlar
• Mimo API Anahtarı: Oluşturun ve İstek Gönderin
• Mistral API Alternatifleri: Sansürsüz LLM Seçeneklerini Karşılaştırma