Minicpm kullanıcıları için hızlı başlangıç

Base URL ve Kimlik Doğrulama

Bu API'yi kullanmak için bir API anahtarına ve doğru base URL'ye ihtiyacınız vardır. Hizmetimiz standart OpenAI istemci kütüphaneleriyle tamamen uyumludur. Yeni bağımlılık yüklemenize veya yeni bir SDK öğrenmenize gerek yoktur. Mevcut istemcinizi sadece uç noktamıza yönlendirin.

Anahtarı API anahtarını al sayfasında oluşturun. Google ile giriş yapabilir veya e-posta ve şifre kullanabilirsiniz. Anahtar hemen görüntülenir. Güvenli bir şekilde saklayın. Her istek, Authorization başlığında bu anahtarı içermelidir.

Tüm istekler için temel URL: https://api.minicpm.cc/v1. Bu URL sohbet tamamlamaları, model listeleme ve akış yanıtlarını yönetir. Gömme veya görüntüleme için ayrı uç noktalar yoktur. Bu metin tabanlı bir API'dir.

İlk İstek

Metin üretmeye başlamak için standart bir sohbet tamamlama isteği gönderin. Model ID'si her zaman uncensored'dir. Bu model, yasal yetişkin kullanımı için içerik reddetmeleri olmadan cevap verecek şekilde ayarlanmış açık ağırlıklı bir büyük dil modelidir. GPT, Claude veya başka bir satıcının modeli değildir.

model alanını uncensored olarak ayarlayın. Mesajlarınızı standart dizi formatında sağlayın. API bir metin yanıtı döndürür. Çıktı uzunluğunu max_tokens ile kontrol edebilirsiniz. Ayarlamazsanız, varsayılan maksimum çıktı 2.048 token'dır.

Python SDK Entegrasyonu

API ile etkileşim kurmak için resmi OpenAI Python kütüphanesini kullanın. Sadece base URL ve API anahtarını yapılandırmanız yeterlidir. Kütüphanenin geri kalanı beklendiği gibi çalışır. Bu, akış, fonksiyon çağırma ve JSON modu desteğini içerir.

Kütüphaneyi pip install openai ile yükleyin. İstemciyi base URL ve anahtarınızla başlatın. Sohbet tamamlama uç noktasına mesaj gönderin. Yanıt nesnesi oluşturulan metni, token kullanımını ve bitiş nedenini içerir. Bu alanlara Python kodunuzda doğrudan erişebilirsiniz.

Node SDK Entegrasyonu

Node.js SDK'sı Python sürümüyle aynı şekilde çalışır. Paketi yükleyin ve base URL'yi yapılandırın. İstemci kimlik doğrulamasını ve istek biçimlendirmesini otomatik olarak halleder. Bu, API'yi arka uç hizmetlerinize hızlıca entegre etmenizi sağlar.

Base URL ve API anahtarını OpenAI istemci kurucusuna iletin. chat.completions.create yöntemini kullanın. Yanıt yapısı OpenAI standardıyla eşleşir. Hataları işleyebilir, token kullanımını kontrol edebilir ve içeriği işleyebilirsiniz. Bu yaklaşım, zaten OpenAI kullanan mevcut kod tabanlarıyla uyumluluğu sağlar.

Akış Yanıtları

İsteğinizde stream: true ayarlayarak akışı etkinleştirin. API bir dizi Server-Sent Events (SSE) döndürür. Her olay yanıtın bir parçasını içerir. Bu, metin kullanıcıya oluşturulduğu gibi gösterilmesini sağlar.

Son parça token kullanım istatistiklerini içerir. Bu maliyetleri izlemek için faydalıdır. Akış, kullanıcılar için algılanan gecikmeyi azaltır. Sohbet arayüzleri için önerilir. Son yanıtı oluşturmak veya tokenları gerçek zamanlı görüntülemek için istemci kodunuzda olayları ayrıştırmalısınız.

Limitler, Hatalar ve Bağlam

Model 100.000 token'lık bir bağlam penceresi destekler. Bu hem istemi hem de tamamlamayı içerir. Her istek için maksimum çıktı 32.000 token'dır. Bunu kontrol etmek için max_tokens parametresini ayarlayabilirsiniz.

Hız limitleri anahtar başına dakikada 300 istek olarak ayarlanmıştır. Eşzamanlı 8 isteğiniz olabilir. İstek gövdesi 8 MB'ın altında olmalıdır. Anahtar geçersizse 401 hatası alırsınız. Krediniz yoksa 402 hatası alırsınız. Hız limitini aşarsanız 429 hatası alırsınız. Hatalar ve reddetmeler krediyi tüketmez.

cURL

Copycurl https://api.minicpm.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minicpm.cc/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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minicpm.cc/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);

Akış

Copystream = 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)

2026-050