TR ▾
API anahtarı al
Geliştiriciler için OpenAI uyumlu sansürsüz API. güncellendi

Kopyalayıp Çalıştırabileceğiniz LLM API curl Örnekleri

Herhangi bir kod yazmadan önce bir LLM API curl testi yapmak isterseniz, aşağıdaki istekler yeterlidir. Her biri OpenAI uyumlu bir uç noktayı hedefler, uncensored model kimliğini kullanır ve düz bir terminalden çalıştırılır.

Bir LLM API'ye curl isteği gönderen bir sunucu küpüne ışın huzmesi gönderen terminal paneli

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

DurumOlası nedenÇözüm
401Eksik veya yanlış anahtarAuthorization başlığını ve $API_KEY'in dışa aktarıldığını kontrol edin
400Bozuk JSON veya hatalı alanGöndermeden önce gövdeyi jq . ile doğrulayın
429, kod rate_limitedDakikada 300'den fazla istek (deneme anahtarında 60)Döngünüzü yavaşlatın
429, kod concurrencyAynı anda 8'den fazla istek (deneme anahtarında 2)Daha az eşzamanlı iş çalıştırın
429 ile Retry-After: 5Geçici aşırı yüklenme5 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).

Sorular ve cevaplar

curl isteklerini hangi URL'ye gönderirim?

https://api.uncensoredllmapi.com/v1'i temel olarak kullanın, ardından ihtiyacınıza göre /chat/completions, /responses, /models veya /balance ekleyin.

curl ile fonksiyon çağırma nasıl test edilir?

Sohbet tamamlama gövdesine bir fonksiyon tanımı içeren tools dizisi ekleyin. Model bunu çağırmaya karar verirse, yanıt tool_calls içerir ve sonucu role tool olan bir mesaj olarak geri gönderirsiniz.

Neden yanıt bitene kadar curl hiçbir şey göstermez?

Muhtemelen -N bayrağı olmadan akış yapıyorsunuz. Her parça geldiğinde curl'in yazması için -N ekleyin.

Başarısız bir istek para tutar mı?

Hayır. Başarısız veya reddedilen istekler için ücret alınmaz.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulum bu kadar.