Entegrasyon Kılavuzu

Hızlı Başlangıç: İlk isteğinizi gönderin

API, Chat Completions yapısını yansıtan OpenAI uyumlu bir API'dir. Metin gönderir, metin alırsınız. Embedding veya ses için ek uç noktalar iş akışınızı karmaşalaştırmaz. İstemcinizi temel URL'mize yönlerek başlayın.

• Temel URL: HTTPS://api.filtrosemia.com/v1
• Model Kimliği: "uncensored"

SDK yapılandırmanızdaki mevcut temel URL'yi değiştirin. Uç nokta, sıradan filtreler olmadan rol yapmaktan çeviriye kadar her şeyi halleder.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

Kimlik Doğrulama ve Headerlar

API anahtarınızı standart Authorization başlığında iletin. Basitlik için hesap başına tek bir aktif anahtar kullanıyoruz. Yeni birine ihtiyacınız olursa panodan oluşturun.

• Başlık: Authorization: Bearer YOUR_API_KEY
• Yönetilecek OAuth akışları veya yenileme belirteçleri yok.

Anahtarınızı güvende tutun. Doğrudan ön ödemeli kredlerinize erişim sağlar. Şu gibi hatalar 401 Unauthorized anahtarın eksik veya geçersiz olduğu anlamına gelir.

Copyfrom openai import OpenAI

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

Sohbet Tamamlamaları Uç Noktası

Şuraya mesaj gönderin POST /v1/chat/completions. Model standart parametreleri destekler gibi temperature, top_p, ve stop diziler. Yetişkin ve yaratıcı içerikler için ayarlanmış sınırlandırılmamış bir modeldir.

• Destekler json_object yanıt formatını
• Fonksiyon çağırma için araç tanımlarını kabul eder.

İstekler hız sınırlarınız içinde sıralı olarak işlenir. Yükünüzün 8 MB altında kaldığından emin olun.

Copyimport OpenAI from "openai";

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

Akış Yanıtları (SSE)

Gerçek zamanlı token teslimi için Sunucu Tarafı Olayları kullanın. Bu, uzun çıktılar için algılanan gecikmeyi azaltır. Son chunk, tam token kullanım istatistiklerini içerir.

• Ayarla stream: true isteğinizde.
• SSE akışını istemcinizde ayrıştırın.

Akış, standart OpenAI SDK davranışıyla aynı şekilde çalışır. Gelen parçaları (chunks) işlersiniz.

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)

Bağlam Penceresi ve Sınırlar

Model 100.000 token'lık bir bağlam penceresi destekler. Bu, uzun geçmişlerle ağır iş yüklerini sağlar. Maksimum çıktı istek başına 16.000 token'dır.

• Varsayılan max output: 2,048 token.
• Hız sınırı: dakikada 300 istek.

Sınırları aşmak bir 429 Too Many Requests eşzamanlılık ayarlarınızı sınırlar içinde tutacak şekilde düzenleyin. Anahtar başına 8 eşzamanlı isteklere izin verilir.

Hata Yönetimi ve Tokenlar

Standart HTTP hatalarını yönetin. 402 Payment Required ön ödemeli kredinizin tükendiği anlamına gelir. 429 hız sınırlamasını belirtir. 401 signals authentication issues.

• Hatalar ücretsizdir. Yalnızca başarılı token kullanımı için ödeme yaparsınız.
• İçerik politikası nedeniyle reddedilenler ücretsizdir.

Yeniden deneme mantığınızı veya kredi yüklemesi sıklığınızı ayarlamak için ayrıntılı hata mesajları için yanıt gövdesini kontrol edin.