Gömme API'si Hızlı Başlangıç Rehberi

Kimlik Doğrulama

API'ya hesap panelinizden oluşturulan benzersiz bir API anahtarı ile erişin. Bu anahtarı her istekte Bearer şemasını kullanarak Authorization başlığına ekleyin. Tüm uç noktalar için temel URL https://api.embeddingapis.com/v1 şeklindedir. Bu URL, resmi OpenAI SDK'ları ve OpenAI uyumlu hizmetler için yapılandırılmış herhangi bir istemci ile çalışır. Anahtarınızı güvende tuttuğunuzdan emin olun, çünkü ön ödemeli kredilerinize erişim sağlar.

Her hesap için yalnızca bir aktif anahtar sınırlaması vardır; bu anahtarı istediğiniz zaman yeniden oluşturabilirsiniz. Anahtarı yeniden oluşturmak öncekini hemen geçersiz kılar, bu nedenle yapılandırmanızı hemen güncelleyin.

Sohbet Tamamlama Uç Noktası

POST /v1/chat/completions uç noktasına metin istemleri gönderin. API, uncensored kimliğiyle tanımlanan tek bir sansürsüz model sunar. Bu model, yasal yetişkin, kurgusal veya güvenlik araştırması konuları için içerik reddi olmadan yanıt verecek şekilde ayarlanmış açık ağırlıklı bir LLM'dir. Metin alır ve metin çıktısı verir; bu da pipeline'ınızdaki son işleme, özetleme veya çıkarma adımları için ideal kılar.

Sisteminiz ve kullanıcı istemlerinizi içeren bir messages dizisi ile isteğinizi yapılandırın. API, oluşturulan metni içeren bir JSON yanıtı döndürür.

Copycurl https://api.embeddingapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK Entegrasyonu

API ile etkileşim kurmak için resmi OpenAI Python kütüphanesini kullanın. base_url değerini uç noktamıza ayarlayın ve API anahtarınızı sağlayın. Bu yaklaşım, minimum değişikliklerle mevcut istemci kodundan yararlanmanıza olanak tanır. İstemci, serileştirmeyi ve ağ isteklerini yönetir; uygulama mantığınız için ayrıştırabileceğiniz yapılandırılmış yanıtlar döndürür.

Akış ve fonksiyon çağırma dahil tüm özellikleri desteklemek için SDK'nın güncel bir sürümünü kullandığınızdan emin olun. Tamamlama çağrılırken model kimliği uncensored olarak kalır.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.embeddingapis.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 SDK Entegrasyonu

JavaScript veya TypeScript ortamları için OpenAI Node.js SDK'sını kullanın. İstemciyi doğru temel URL ve API anahtarıyla yapılandırın. Bu kurulum, mevcut Node tabanlı pipeline'larınızla uyumluluğu sağlar. SDK, bağlantıyı POST /v1/chat/completions uç noktasına yönetir ve istek göndermenizi ile metin tamamlamaları almanızı verimli hale getirir.

Bu entegrasyon; alt yazı, senaryo oluşturma veya büyük metin bloklarından veri çıkarma gibi sunucu taraflı metin işleme için uygundur.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.embeddingapis.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ışlı Yanıtlar

Düşük gecikme süreli uygulamalar için isteğinizde stream: true ayarlayarak akışı etkinleştirin. API, tokenlar oluşturuldukça onları teslim eden bir Sunucu Tarafı Olayları (SSE) akışı döndürür. Bu, gerçek zamanlı kullanıcı arayüzleri veya anında geri bildirim değerli olan uzun metinleri işlerken özellikle yararlıdır.

Kısmi yanıtları işlemek için SSE akışını ayrıştırın. Sansürsüz model bu modu destekler; böylece tüm tamamlama tamamlanmadan içeriği üretilirken tepki verebilirsiniz.

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

Bağlam penceresi, hem istem hem de tamamlama için birlikte 100.000 token destekler. 8 MB gövde sınırını veya dakikada 300 istek hız limitini aşan istekler başarısız olur. Kimlik doğrulama hataları, anahtar geçersizse 401 durumunu döndürür. Ön ödemeli kredi tükendiğinde, token kullanımını karşılayacak kredi kalmadığı için istekler başarısız olur. 429 durumu, hız limitinin dolduğunu gösterir.

Sert bir içerik sınırı her zaman geçerlidir: küçüklerle ilgili cinsel içerik içeren istekler, diğer ayarlardan bağımsız olarak engellenir. Diğer tüm yasal yetişkin içerikler reddedilmeden işlenir.