API Dokümantasyonu

Temel URL ve Kimlik Doğrulama

API uç noktası şurada bulunur https://api.openrouteraiapi.com/v1. API anahtarınızı şurada geçirin Authorization header'ı bearer token olarak kullanın. Bu header, trafiği mevcut sağlayıcınızdan uncensored modelimize yönlendirmek için gereken tek değişikliktir.

Kimlik doğrulama katıdır. Anahtar eksik veya geçersizse sunucu hemen 401 hatası döndürür. Anahtarınızı kontrol panelinde Google veya e-posta ile anında oluşturabilirsiniz. Anahtarınızı güvende tutun, çünkü ön ödemeli kredilerinize erişim sağlar.

Sohbet Tamamlamaları Uç Noktası

POST isteklerini gönderin /v1/chat/completions bir mesaj dizisi ile. Model tanımlayıcısı uncensored. Bu tek model, karmaşık yönlendirme mantığı olmadan tüm metin üretimi ihtiyaçlarınızı karşılar.

Bağlantıyı ve yanıt formatını doğrulamak için cURL kullanan standart bir istek.

Copycurl https://api.openrouteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
  }'

Yanıt, oluşturulan metni şurada içerir: choices[0].message.content alanı. Bunu doğrudan uygulama iş akışınıza ayrıştırebilirsiniz.

Python SDK Entegrasyonu

Sorunsuz bağlanmak için resmi OpenAI Python istemcisini kullanın. Ayarlayın base_url ve api_key değişkenlerini altyapımıza yönlendirmek için. Bu yaklaşım, sağlayıcılar arasında geçiş yaparken kod değişikliklerini minimize eder.

Copyfrom openai import OpenAI

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

İstemci serileştirmeyi ve yeniden denemeleri otomatik olarak halleder. Metni ve token kullanım istatistiklerini içeren bir tamamlama nesnesi alırsınız. Bu yöntem arka uç hizmetleri ve betikler için idealdir.

Node.js SDK Kullanımı

Özel temel URL'nizle OpenAI Node.js istemcisini başlatın. Bu, JavaScript uygulamalarının tanıdık yöntemleri kullanarak uncensored modelle etkileşim kurmasını sağlar. SDK, HTTP isteklerini verimli bir şekilde yönetir.

Copyimport OpenAI from "openai";

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

Çağrı chat.completions.create() mesajlarınızla birlikte. Yanıt nesnesi oluşturulan içeriğe ve kullanım verilerine erişim sağlar. Bu entegrasyon web sunucuları ve kenar işlevleri için iyi çalışır.

Akış Yanıtları

Ayarlayarak akışı etkinleştirin stream: true istekinizde. Sunucu, gerçek zamanlı token teslimi için Sunucu Gönderilen Olaylar (SSE) döndürür. Bu özellik, son kullanıcılar için algılanan gecikmeyi azaltır.

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)

Her parça kısmi içerik içerir. Son parça tam token kullanım istatistiklerini içerir. Arayüzü kademeli olarak güncellemek için bu olayları istemcinizde işleyin.

Limitler, Hatalar ve Bağlam Penceresi

Bağlam penceresi, birleşik giriş ve çıkış için 100.000 tokene destek verir. Her istek 16.000 tokene kadar çıktı verebilir veya max_tokens ayarlanmamıştır. Hız sınırları, anahtar başına dakikada 300 istek öngörür.

Hatalar standart HTTP kodlarıdır. 401 geçersiz bir anahtarı gösterir. 402 ön ödemeli kredinizin tükendiğini belirtir. 429 hız sınırını aştığınızı işaret eder. Başarısız istekler krediyi tüketmez. Hatalar ücretsizdir.