İstemcinizi üç satırda değiştirin
Bu hızlı başlangıç kılavuzu, standart Mistral uç nokta formatını kullanarak sansürsüz, OpenAI uyumlu API'mize nasıl entegre edileceğini gösterir. Kimlik doğrulaması yapmayı, istek göndermeyi ve sıfır yapılandırma yüküyle akış yanıtlarını işlemeyi öğreneceksiniz.
Temel URL ve Kimlik Doğrulama
API'yi kullanmak için istemcinizi https://api.mistralapi.top/v1 adresine yönlendirin. Kimlik doğrulama, Authorization başlığında dahil edilen bir Bearer token'ına dayanır. Bu anahtarı, Google hesabınızı veya standart e-posta/şifre kurulumunuzu kullanarak API anahtarını al sayfasından oluşturursunuz. Anahtar oluşturulduğu anda gösterilir. Bu token'ı güvende tutun, çünkü ön ödemeli kredinize tam erişim sağlar. Standart sağlayıcıların aksine, başlangıç deneme kredisi aktivasyonu için telefon numarası veya kredi kartı gerektirmiyoruz.
Hizmetimiz, mevcut Mistral veya OpenAI istemci yapılandırmalarına doğrudan entegre olacak şekilde tasarlanmıştır. SDK örneğinizdeki base_url özelliğini güncellemeniz yeterlidir. Uç nokta yapısı standart /v1/chat/completions formatıyla eşleşir, böylece mevcut kodunuzda değişiklik yapmadan çalışır. Tek bir uncensored model kimliği desteklenir ve tüm metin oluşturma görevlerini yönetir.
Sohbet Tamamlama Uç Noktası
Temel etkileşim POST /v1/chat/completions uç noktası üzerinden gerçekleşir. model ID'nizi, messages dizinizi ve isteğe bağlı parametreleri içeren bir JSON gövdesi gönderirsiniz. API, JSON modu belirtirseniz metin yanıtı veya yapılandırılmış veri döndürür. Bu uç nokta, LLM ile etkileşiminin temel yoludur. Hem standart eşzamanlı istekleri hem de akış yanıtlarını destekler. Her istek, girdi ve çıktı hacmine göre ön ödemeli bakiyenizden token tüketir.
Hatalar standart HTTP durum kodları aracılığıyla işlenir. Anahtarınız geçersizse 401 alırsınız. Krediniz biterse 402 alırsınız. Hız limitleri dakikada 300 istek ve anahtar başına 8 eşzamanlı bağlantı ile uygulanır. Bağlantınızı ve anahtar geçerliliğinizi doğrulamak için aşağıdaki örneği kullanın.
curl https://api.mistralapi.top/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Akış Yanıtları (SSE)
Daha düşük gecikme süresi ve daha iyi kullanıcı deneyimi için istek gövdenizde stream: true ayarını yaparak akış özelliğini etkinleştirin. API, SSE (Server-Sent Events) akışı döndürür. Her parça kısmi bir yanıt içerir. Son parça, istek için tam token kullanım istatistiklerini içerir. Bu, uygulamanızın tam tamamlama beklemek yerine tokenlar oluşturulurken bunları göstermesini sağlar. Akış, anında geri bildirim kritik olduğunda sohbet arayüzleri için idealdir.
Akış kullanırken istemcinizin SSE formatını doğru şekilde ayrıştırdığından emin olun. Her parçadaki choices dizisi, delta içeriği içerecektir. Tam yanıtı oluşturmak için bu delta birikimini yapmanız gerekir. Token kullanımı yalnızca akıştaki son olayda mevcuttur. Model karmaşık istemleri işlerken kullanıcılarınızı meşgul tutmak için bu yöntemi kullanın.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Python
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralapi.top/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mistralapi.top/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Sorular ve cevaplar
Bu resmi Mistral API'si mi?
Hayır. Mistral API uç nokta yapısını taklit eden bağımsız bir hizmetiz. Mistral'ın özel modellerini değil, kendi sansürsüz modelimizi sunuyoruz. Aynı istemci uyumluluğunu ancak farklı içerik politikaları ve fiyatlandırma ile istiyorsanız bu API'yi kullanın.
Kredimi nasıl yüklerim?
Yüklemeler yalnızca kripto para birimi ile yapılır (TRC20 üzerinde USDT veya Base üzerinde USDC). Minimum yükleme $10, maksimum $500'dür. $50 üzeri yüklemeler için %5, $100 üzeri yüklemeler için %10 bonus alırsınız. Kredi kartı veya PayPal kabul edilmez.
Bağlam penceresi sınırı nedir?
Model, hem istem hem de tamamlama için birlikte 100.000 token bağlam penceresini destekler. İstek başına maksimum çıktı 32.000 token'dır veya <code>max_tokens</code> parametresini belirtmezseniz 2.048 token'dır.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Tüm kurulum bu.
Teknik özellikler
Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.
| Öğe | Değer |
|---|---|
| Biçim | OpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır |
| Model kimliği | uncensored |
| Base URL | https://api.mistralapi.top/v1 |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| JSON modu | response_format: {"type": "json_object"} |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| İstek boyutu | en fazla 8 MB |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Hız limiti | anahtar başına dakikada 300 istek |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Ücretsiz deneme | $0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300) |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Giriş | Google veya e-posta ve şifre |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
Hata kodları
Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.
| Kod | Tür | Anlamı |
|---|---|---|
400 | bad_request | geçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun |
401 | missing_key · invalid_key · key_revoked | anahtar yok, yanlış veya değiştirilmiş |
402 | no_credit | kredi bitti — yükleyin, hemen devam eder |
403 | content_blocked | reşit olmayanları içeren cinsel içerik — reddedildi, ücret yok |
404 | not_found | bilinmeyen uç nokta |
413 | request_too_large | gövde 8 MB'tan büyük |
429 | rate_limited · concurrency | dakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin |
503 | upstream_busy | model meşgul — birkaç saniye sonra tekrar deneyin |