API Dokümantasyonu

Kimlik doğrulama ve base URL

Anahtarınızı dashboard'da oluşturun. Temel URL'miz HTTPS://api.aivenice.cc/v1'dir. Anahtarınızı Authorization başlığında iletin. Bir hesap başına tek aktif anahtar, eskisini otomatik olarak değiştirir.

İlk istek örneği

Bağlantıyı test etmek için basit bir sohbet tamamlama isteği gönderin. Model kimliği "uncensored"dir. Metni giriş ve çıkış olarak verimli şekilde işler. Yaratıcılık için sıcaklık gibi parametreleri ayarlayabilirsiniz.

Copyfrom openai import OpenAI

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

Hatalar ücretsizdir. Reddederler krediden düşmez. Bu, ilk çağrınızdan itibaren tahmin edilebilir faturalandırmayı sağlar.

Node.js entegrasyonu

Entegrasyonu kolaylaştırmak için resmi Node SDK'sını kullanın. Temel URL'yi uç noktamıza ayarlayın. API anahtarınızı yapılandırma nesnesinde iletin. Bu yaklaşım, çoğu standart OpenAI-uyumlu kütüphane ile çalışır.

Copyimport OpenAI from "openai";

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

Yanıtları doğrudan JavaScript ortamınızda yönetin. Yapı, tanıdıklık için standart OpenAI formatlarıyla eşleşir.

Akış yanıtları

Akışı etkinleştirmek için stream parametresini true olarak ayarlayın. Oluşturuldukları gibi tokenlar alırsınız. Bu, kullanıcılar için algılanan gecikmeyi azaltır. Son parça toplam token kullanım ayrıntılarını içerir.

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)

Arayüzünüzü gerçek zamanlı güncellemek için SSE olaylarını ayrıştırın. Bu, anında geri bildirim gerektiren sohbet arayüzleri için idealdir.

Parameters and limits

Kontrol için sıcaklık, top_p ve seed'i ayarlayın. Maksimum çıktı 16.000 token'dır. Bağlam penceresi 100.000 token'dır. Hız sınırı dakikada 300 istektir. Gövde boyutu 8 MB'a kadar çıkar.

Bu limitler stabil performans sağlar. Hız sınırlarını aşmanız 429 hatasına yol açar. Gerekirse eşzamanlılığı artırın.

Hatalar ve bağlam penceresi

Geçersiz anahtarlar için 401'i yönetin. Kredi azaldığında 402 kullanın. 429 hız sınırının aşıldığını gösterir. Hatalar ve reddetmeler ücretsizdir. Ön ödemeli krediniz hiç sona ermez. Bağlam penceresi, istem ve tamamlama tokenlarını birlikte sayar.

Akıştaki son parça aracılığıyla kullanımı izleyin. Bu, bütçe içinde kalmanıza yardımcı olur. Gizli ücretler yoktur.

cURL

Copycurl https://api.aivenice.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the latest error logs from server logs"}]
  }'