Kabuk ortamınızı kurun ve uç noktayı kontrol edin
API anahtarı sayfasından bir anahtar alın, ardından her komuta gizli bilgileri yapıştırmamak için onu temel URL ile birlikte dışa aktarın.
export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"
Her istek, anahtarı Authorization başlığında bearer token olarak gönderir. Gövde JSON formatında olduğundan, POST isteği yaparken Content-Type: application/json ekleyin. Maksimum gövde boyutu 8 MB'tır; bu durum, yalnızca çok büyük belgeleri istem gövdesine yapıştırırsanız önem taşır.
Örnekler Unix kabuğunun tek tırnaklarını kullanır. Windows PowerShell'de, tırnak işareti sorunlarını önlemek için JSON'u bir dosyaya koyun ve --data @body.json ile gönderin.
En ucuz doğruluk kontrolü, modelleri listeleyen bir GET isteğidir. Bu, anahtarı ve URL'yi doğrular ve hiçbir maliyeti yoktur.
curl -s "$BASE/models" \
-H "Authorization: Bearer $API_KEY"
Yanıttaki data dizisi uncensored kimliğini içermelidir. 401, anahtarın eksik veya yanlış yazıldığını gösterir. curl hiç bağlanamazsa, $BASE içindeki ana bilgisayarı kontrol edin ve /v1 ile bittiğinden ve ekstra yol içermediğinden emin olun.
1. Bir sohbet tamamlaması gönderin
Bu, her OpenAI tarzı istemcinin arka planda gönderdiği istektir.
curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Give me three names for a fantasy tavern."}
],
"temperature": 0.8,
"max_tokens": 200
}'
Yanıt JSON'dur. Metin choices[0].message.content konumundadır ve token sayıları usage içindedir. Yalnızca metni istiyorsanız ve jq yüklüyse çıktıyı jq -r '.choices[0].message.content' üzerinden geçirin. max_tokens alanı isteğe bağlıdır; bırakırsanız üretim, 100.000 tokenlik pencerenin kalanını kullanabilir.
Yeni POST /v1/responses uç noktası da mevcuttur, istemciniz bu formatı kullanıyorsa. Parametrelerin tam listesi için belgelere bakın.
2. Cevabı akışlı olarak alın
"stream": true ekleyin ve curl'un tamponlamaması için -N belirtin. Tokenlar oluşturuldukça yazdırılacaktır.
curl -N "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Count from one to ten in words."}]
}'
Her satır data: ile başlar ve bir delta içeren küçük bir JSON parçası içerir. Son olaylar kullanım bilgisini taşır ve akış data: [DONE] ile biter. -N olmadan curl tam bir tampon için bekler ve çıktı tek bir yığın halinde geliyormuş gibi görünür. Akışlı bir isteğin sonlanana kadar bir eşzamanlılık slotunu meşgul ettiğini unutmayın.
3. JSON isteyin
Bir betiğin ayrıştıracağı çıktı için response_format ile JSON modunu etkinleştirin. Modelin beklediğiniz yapıyı bilmesi için isteme JSON kelimesini ekleyin.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [{"role": "user",
"content": "Return JSON with keys name and level for a fantasy character."}]
}' | jq -r '.choices[0].message.content | fromjson'
Son fromjson filtresi, content içindeki dizgiyi ayrıştırır, böylece model geçerli JSON olmayan bir şey döndürürse jq açık bir hata mesajı verir. Bu, kullanışlı bir hızlı test yapar. Daha fazla desen JSON modu sayfasında mevcuttur.
4. Bir araç çağrısı deneyin
Araç çağırma, modelin kodunuzun bir fonksiyonu çalıştırmasını sağlar. Fonksiyonu bir tools dizisiyle tanımlarsınız ve model onu kullanmaya karar verirse, yanıt metin yerine bir tool_calls girdisi içerir.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"tool_choice": "auto"
}' | jq '.choices[0].message.tool_calls'
Bir fonksiyon adı ve argümanların JSON dizgesi almalısınız. Kodunuz fonksiyonu çalıştırır, ardından önceki mesajları tekrar eden, araç çağrısını içeren asistan mesajını ekleyen ve sonuç içeren role: "tool" mesajıyla ikinci bir istek gönderir. Model ardından nihai cevabı yazar.
5. Başlıkları ve bakiyeyi kontrol edin
Gövdeyle birlikte yanıt başlıklarını görmek için -i ekleyin. X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests ve X-RateLimit-Limit-Concurrency bulunur.
curl -s -i "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
| grep -i "^x-"
curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"
İkinci çağrı kredinizi doğrudan döndürür. OpenAI tarzı araçlar bunun yerine GET /v1/dashboard/billing/credit_grants kullanabilir. Yukarıdaki gibi küçük bir istek, kuruşun çok küçük bir kısmına mal olur: 10 girdi token ve 5 çıktı token ile fiyat 10 x 0.15 / 1,000,000 + 5 x 0.50 / 1,000,000 = $0.000004'dür. Oranlar için fiyatlandırma sayfasına bakın.
Yeniden kullanılabilir bir ilk çalışma testi betiği
Tek tek çağrılara güvendikten sonra, bunları herhangi bir dağıtım, anahtar rotasyonu veya ağ değişikliğinden sonra çalıştırabileceğiniz kısa bir betiğe sarın. İlk sorunla başarısız olur, böylece hangi adımın bozulduğunu tam olarak görürsünüz.
set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"
echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'
echo "chat:"
curl -sf "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
| jq -r '.choices[0].message.content'
echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"
-f bayrağı curl'un HTTP hatalarında hata ile çıkmasını sağlar ve set -e betiği orada durdurur. Bu API'nin üzerinde bir hizmet çalıştırıyorsanız ve bir şeyler değiştiğinde erken uyarı istiyorsanız bunu bir cron işine veya CI adımına koyun. Anahtarı bir gizli depoda veya ortam değişkenine koyun, asla betik dosyasının kendisinde değil.
İsteği değiştirdiğinizde, bir ayarı tek tek deneyin: rastgelelik için temperature, nucleus örnekleme için top_p, özel bitiş dizileri için stop ve tekrarlanabilir çıktı için seed. Bunların hepsi modele iletilir, bu nedenle aynı terminal geçmişinden etkilerini karşılaştırabilirsiniz.
curl hatalarını okuyun
| Durum | Olası neden | Çözüm |
|---|---|---|
| 401 | Eksik veya yanlış anahtar | Authorization başlığını ve $API_KEY'in dışa aktarıldığını kontrol edin |
| 400 | Bozuk JSON veya hatalı alan | Göndermeden önce gövdeyi jq . ile doğrulayın |
429, kod rate_limited | Dakikada 300'den fazla istek (deneme anahtarında 60) | Döngünüzü yavaşlatın |
429, kod concurrency | Aynı anda 8'den fazla istek (deneme anahtarında 2) | Daha az eşzamanlı iş çalıştırın |
429 ile Retry-After: 5 | Geçici aşırı yüklenme | 5 saniye bekleyin ve yeniden deneyin |
Gövdeden sonra durum kodunu yazdırmak için -w "\n%{http_code}\n" ekleyin, bu da tahmin etme ihtimalinden sizi kurtarır. Hata gövdeleri bir mesaj ve bir kod içeren JSON'dur, bu nedenle jq .error bunları temiz bir şekilde gösterir. Bir döngüde 429 görürseniz, hemen yeniden deneme yapmayın; birkaç saniyelik bir bekleme, dakika penceresinin ve eşzamanlı slotların boşalmasını sağlar ve sık bir yeniden deneme döngüsü sizi sadece sınırların üzerinde tutar. Bir deneme anahtarı, tam bir anahtardan daha sıkı sınırlara sahiptir, bu nedenle ilk bakiye yüklemeden sonra çalışan bir betik, eşzamanlı olarak işler çalıştırıyorsa deneme kredisiyle başarısız olabilir. İstekler düzgün çalıştığında bir SDK'ya geçin; aynı URL ve model adı değişmeden aktarılır. Yeni hesaplar tek tıkla $0,50 deneme kredisi talep edebilir; bu, yüzlerce küçük test çağrısı için yeterlidir. Sonraki yüklemeler $20'den başlar ve kripto ile ödenir (TRC20 üzerinde USDT veya Base üzerinde USDC).
