tr ▾
Anahtarınızı alın

Dakikalar içinde routerapi entegre edin

Mevcut OpenAI-uyumlu kodunuzu routerapi'ye tek bir değişken değişikliğiyle yerleştirin. Entegrasyon mantığınızı yeniden eğitmeden dakikalar içinde bir sansürsüz uç nokta çalıştırın.

İçerikler

Kimlik Doğrulama ve Base URL Kurulumu

Değiştir base_url ve api_key sağlayıcıları anında değiştirmek için. SDK'nızı HTTPS://api.routerapi.cc/v1 adresine işaret edin ve kontrol panelinizden oluşturulan anahtarı kullanın. Karmaşık yönlendirme kurallarına veya çoklu model yapılandırmaya gerek yoktur. Mevcut başlıklarınız ve istemci kurulumunuz OpenAI standardıyla aynı kalır.

Anahtar, Google veya e-posta ile kayıt sonrası hemen görüntülenir. Güvenli bir şekilde saklayın ve Bearer HTTP Yetkilendirme başlığınızda token. Bu tek değişiklik, uygulama kodunuzu değiştirmeden tüm istekleri uncensored modelimize yönlendirir.

Sohbet Tamamlama İsteği Gönderme

Standart bir POST istem /v1/chat/completions metin oluşturmak için. Uç nokta, OpenAI tarafından kullanılan aynı JSON yapısını kabul eder, bu da istemlerinizin değişiklik yapmadan çalışmasını sağlar. Model kimliğini uncensored içerik filtreleri olmadan yanıt veren büyük dil modelimize erişim.

Her istek, ön ödemeli bakiyenizden token tüketir. Hatalar ve reddetmeler kredinizi ücretlendirmez, bu yüzden özgürce test edebilirsiniz. Aşağıdaki örnek, resmi SDK kullanılarak yapılan temel bir metin üretme çağrısını gösterir.

curl https://api.routerapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 1000 word article in three sentences."}]
  }'

Yanıt, oluşturulan metni choices[0].message.content alanı. Parametreleri temperature ou top_p yaratıcılığı kontrol etmek için. Gömme (embedding) veya görüntü oluşturma uç noktaları mevcut değildir; bu hizmet yalnızca metin tamamlamaya odaklanır.

Akış Yanıtlarını (SSE) İşleme

Ayarlayarak akışı etkinleştirin stream: true istemci gövnenizde. API, gerçek zamanlı token teslimi için Sunucu Tarafı Olayları (SSE) döndürür. Bu, sohbet arayüzleri ve rol yapma uygulamaları için algılanan gecikmeyi azaltır. Her parça, yanıtın kısmi bir delta'sını içerir.

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)

Son parça, istek için tam token kullanım istatistiklerini içerir. Parse the content field her delta'dan tam mesajı yeniden oluşturun. Bu yaklaşım, model uzun bağlamları işlerken kullanıcı arayüzünüzün yanıt vermesini sağlar. Son chunk'taki token sayıları hem giriş hem de çıktı kullanımını yansıtır.

Araçlar ve Fonksiyon Çağırma Kullanımı

Araç tanımlarını tools işlev çağırma yeteneğini etkinleştiren parametre. Model, düz metin yerine yanıtta yapılandırılmış araç çağrıları döndürür. Şunu belirtin tool_choice modelin belirli bir işlevi kullanmasını veya otomatik olarak seçmesini sağlamak için. Bu özellik, OpenAI işlev çağırma formatıyla aynı şekilde çalışır.

from openai import OpenAI

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

İşlevlerinizi JSON şemaları ile tanımlayın ve isteğe iletin. API, metin üretimi ile araç çağırma arasındaki yönlendirmeyi yönetir. Şunu kullanın response_format ile {"type": "json_object"} araçların gerekli olmadığı durumlarda katı JSON çıktısı için. Bu, arka uç hizmetleriniz için tutarlı yapılandırılmış veri sağlar.

Yapılandırılmış Çıktı için JSON Modunun Ayarlanması

response_format parametresini ayarlayarak modelin geçerli JSON çıktısı vermesini sağlayın. response_format için {"type": "json_object"}. Otomatik iş akışlarında veya AI ajanlarında veri ayrıştırmak için bu önemlidir. Model, tüm parantezleri kapatmaya ve istenen şemayı izlemeye çalışacaktır. Çıktı bağlam penceresi için çok uzun hale gelirse hatalar oluşabilir.

import OpenAI from "openai";

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

JSON modunu temperature maksimum determinizm için 0 olarak ayarlayın. Varlık çıkarma, veri biçimlendirme veya yapılandırma dosyası oluşturma için kullanın. Sansürsüz model karmaşık iç içe yapıları iyi işler. İşlemeden önce her zaman çıktıyı kodunuzda doğrulayın.

Token Limitleri ve Maliyetler

Bağlam penceresi, hem istem hem de tamamlama için birlikte 100.000 jetonu destekler. Her istek 16.000 jetona kadar çıktı verebilir veya 2.048 jeton, eğer max_tokens ayarlanmamıştır. Fiyatlandırma, milyon giriş token'ı başına $0.15 ve milyon çıktı token'ı başına $0.50'dir. Kredi süresi dolmaz ve hatalar ücretsizdir.

Panel veya yanıt başlıkları üzerinden kullanımınızı izleyin. İstekler gövde boyutu açısından 8 MB ile sınırlıdır. USDT (TRC20) veya USDC (Base) ile 20 $'dan başlayan şekilde yeniden yükleyebilirsiniz. Bonus kredi daha büyük yatırımlarla artar: 50 $'da +%5, 100 $'da +%10 ve 200 $'da +%15. Abonelik ücreti yoktur.

Sıkça sorulan sorular

Hız sınırlarını ve hataları nasıl yönetebilirim?

API, anahtar başına dakikada 300 istek ve 8 eşzamanlı istek sınırı uygular. 429 durum kodu bu sınırları aştığınızı gösterir; yeniden denemeden önce kısa bir süre bekleyin. 401 hatası API anahtarınızın geçersiz olduğunu, 402 hatası yetersiz ön ödemeli krediyi gösterir. Hangi sınırın tetiklendiğine dair ayrıntılar için hata mesajı gövdesini kontrol edin.

Routerapi yüksek hacimli üretim kullanımı için uygun mu?

Evet, hizmet düşük gecikme süreli uygulamalar için eşzamanlı istekleri ve streaming'i destekler. Ancak SLA garantileri ve gömme (embeddings) gibi gelişmiş özellikler bulunmaz. Censorship olmadan çıktıların kritik olduğu sohbet, rol yapma veya yaratıcı yazım için kullanın. Ön ödemeli bakiyenizin hacmi karşılayıp karşılamadığını sağlamak için token kullanımınızı izleyin.

Hata yaparsam kredimle ne olur?

Kredi ön ödemelidir ve süresi dolmaz, bu nedenle kullanılmayan fonlar süresiz olarak kullanılabilir durumda kalır. Çift ücretlendirme gibi hatalar Destek sayfası üzerinden çözülür. Hatalar ve reddler kredinizi tüketmez, bu nedenle promptlarınızı test etmek ücretsizdir. İstediğiniz zaman kripto kullanarak tekrar yükleyebilirsiniz.

API Anahtarınızı Alın

Kaydol, anahtarı al ve yeni temel URL'ye yönlendir. Tamam.