Apertus ia API Documentation

1. Quickstart: Connect Your First Request

Temel URL https://api.apertusia.com/v1 şeklindedir. API anahtarınızı Authorization başlığında iletin. Model tanımlayıcısı uncensored olarak ayarlanmalıdır. Bu yapılandırma, herhangi bir OpenAI uyumlu istemci ile çalışır.

Bağlantıyı hemen test etmek için bu cURL komutunu kullanın. YOUR_API_KEY yerine kendi API anahtarınızı yazın.

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

Kimlik doğrulama hataları 401 döndürür. Yetersiz bakiye 402 döndürür. Hız limitleri 429 döndürür.

2. Desteklenen Parametreler: Sıcaklık, Top P ve Seed

temperature ile rastgeleliği, top_p ile çeşitliliği ve seed ile yeniden üretilebilirliği kontrol edin. Bu parametreler standart OpenAI kurallarını takip eder. Dengeli bir çıktı için temperature değerini 0.7, daha yüksek yaratıcılık için 1.0 olarak ayarlayın. top_p ile örnekleme işlemini en yüksek olasılık kütlesine sınırlandırın. seed parametresi hata ayıklama için aynı çıktılar elde etmenizi sağlar.

Yerel testler için örnek Python kod parçacığı:

Copyfrom openai import OpenAI

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

3. Sunucu Tarafından Gönderilen Olaylarla Akış Yanıtları

Akışı etkinleştirmek için stream: true ayarını yapın. API, verileri Sunucu Tarafı Olayları (Server-Sent Events) aracılığıyla parçalar halinde döndürür. Her parça, kısmi metin ve token kullanım verileri içerir. Bu, uzun yanıtlar için algılanan gecikmeyi azaltır. Arayüzünüzü gerçek zamanlı olarak güncellemek için SSE olaylarını işleyin.

Resmi SDK ile Node.js örneği:

Copyimport OpenAI from "openai";

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

4. Fonksiyon Çağırma ve JSON Modu Yapılandırması

response_format parametresini {"type": "json_object"} ile birlikte kullanarak sıkı JSON çıktısı elde edin. Bu, programatik veri boruhatları için yapılandırılmış veri sağlar. İstek gövdesinde bir tools dizisi sağlayarak fonksiyon çağırma özelliğini etkinleştirin. Model, araç çağrılarını beklenen formatta döndürecektir. Belirli davranışı zorlamak için tool_choice kullanın.

5. İstek Hız Sınırlamaları ve İstek Boyutu Kısıtlamaları

Her API anahtarı dakikada 300 isteği destekler. Eşzamanlı istekler anahtar başına 8 ile sınırlıdır. Maksimum istek gövdesi boyutu 8 MB'tır. Bağlam penceresi toplamda 100,000 token tutar. İstek başına maksimum çıktı, tam 100,000 tokenlik pencereye kadardır. Kesilmeyi önlemek için max_tokens değerini boş bırakın veya yüksek bir değerle ayarlayın. Hatalar krediyi tüketmez. İade yapılmaz, ancak faturalandırma hataları Destek aracılığıyla düzeltilir.

6. Kimlik Doğrulama ve Hata Yönetimi

Anahtarınızı panelden oluşturun. Google girişi veya e-posta kullanın. Anahtar hemen görünür. Bunu Authorization: Bearer başlığına ekleyin. Geçersiz anahtarlar 401 döndürür. 429 hataları, oran sınırının dolmuş olduğunu gösterir. 402 hataları, ön ödemeli kredinizin tükendiğini ifade eder. USDT veya USDC ile yükleyin. Krediler asla sona ermez.

Akış

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)