Geliştiriciler için Entegrasyon Kılavuzu

Kimlik doğrulama ve base URL kurulumu

API anahtarınızı dashboard'da oluşturun. Temel URL HTTPS://api.apiaicheap.com/v1'dir. Anahtarınızı Authorization başlığında bearer token olarak gönderin.

• "API Anahtarı Al"ı tıklayın ve Google veya e-posta ile oturum açın.
• Anahtarı hemen kopyalayın; yalnızca bir kez gösterilir.

Bu anahtar, sohbet tamamlama uç noktasına yapılan tüm istekleri doğrular.

Örnek Başlık

Yetkilendirme: Bearer YOUR_API_KEY

İlk istek (cURL ile)

Kurulumunuzu test etmek için temel bir sohbet tamamlama gönderin. Model "uncensored" ile POST /v1/chat/completions uç noktasını kullanın.

Bu, kredi bakiyenizi ve gecikme sürenizi doğrular.

• Rolü "user" olarak ayarlayın.
• İlk test için mesajı basit tutun.

Oluşturulan metin alanı için yanıtı kontrol edin.

• "content" değerini arayın.

200 OK yanıtı alırsanız, entegrasyonunuz çalışıyor demektir.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Python SDK entegrasyonu

Resmi OpenAI Python kütüphanesini kullanarak kolay entegrasyon sağlayın. Base URL'i bizim uç noktamıza işaret edin ve API anahtarınızı ayarlayın.

Bu yaklaşım, yeniden denemeleri ve JSON ayrıştırmayı otomatik olarak halleder.

• Kütüphaneyi pip aracılığıyla yükleyin.
• base_url parametresini uç noktamıza ayarlayın.

chat.completions.create metodunu çağırın.

Mesaj listenizi bir argüman olarak iletin.

• Model adını "uncensored" olarak dahil edin.

Nesnenin öznitelikleri aracılığıyla yanıt metnine erişin.

Bu yöntem, üretim betikleri için temiz ve okunaklıdır.

Copyfrom openai import OpenAI

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

Node.js SDK kurulumu

Node.js SDK Python sürümüne benzer şekilde çalışır. İstemciyi anahtarınız ve temel URL'mizle başlatın.

Bu, size tanıdık async/await kalıplarını kullanma imkanı sağlar.

• OpenAI paketini içe aktarın.
• Yapıcıda temel URL'yi yapılandırın.

Mesajlarınızla bir tamamlama isteği oluşturun.

Sonucu almak için sözü yönetin.

• Yanıttan mesaj içeriğini çıkarın.

Modelin doğru yanıt verdiğini doğrulamak için çıktıyı günlüğe kaydedin.

Bu yapı, web sunucuları ve arka uç hizmetleri için idealdir.

Copyimport OpenAI from "openai";

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

SSE ile akış yanıtlar

Akış özelliğini etkinleştirmek için isteğinizde stream parametresini true olarak ayarlayın. API, oluşturuldukları şekilde Sunucu Tarafından Gönderilen Olaylar aracılığıyla parçaları döndürür.

Bu özellik sohbet uygulamalarında kullanıcılar için algılanan gecikmeyi azaltır.

• Payload'da stream: true değerini ayarlayın.
• Her parçayı geldiği gibi işleyin.

Parçaları birleştirerek nihai yanıtı oluşturun.

Token kullanım detayları son chunk'ta görünür.

• Son chunk'taki "usage" alanını kontrol edin.

Bu yaklaşım, uzun üretimler sırasında kullanıcı arayüzünün yanıt verici kalmasını sağlar.

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)

Limitler, hatalar ve bağlam penceresi

Hesabınız anahtar başına dakikada 300 istek limitiyle sınırlıdır. Bağlam penceresi istem ve tamamlama için toplam 100.000 token'ı destekler.

Hatalar standart HTTP durum kodları ile işlenir.

• 401 geçersiz veya eksik bir API anahtarı olduğunu gösterir.
• 402 ön ödemeli kredinizin tükendiğini gösterir.
• 429 hız sınırını aştığınızı işaret eder.

Redler krediye mal olmaz. Hatalar da ücretsizdir.

Maksimum çıktı istek başına 16.000 token'dır. Daha az ihtiyacınız varsa max_tokens'u ayarlayın.

Bu yapı öngörülebilir faturalandırma ve performans sağlar.