TR ▾
API anahtarı al

OpenAI Uyumlu API Uç Noktaları: Desteklenenler

Bu hizmetin desteklediği OpenAI uyumlu API uç noktalarının listesi, her biri için çalışan istekler ve eksik olanların düz bir listesi.

güncellendi

Temel noktalar

  1. Beş yol: sohbet tamamlamaları, yanıtlar, modeller ve iki bakiye rotası.
  2. Model kimliği uncensored'dır ve tek bir anahtar herhangi bir OpenAI SDK'sı ile çalışır.
  3. Resimler, ses, video, gömme vektörler veya ince ayar yok.
  4. Limitler HTTP 429 hatası döndürür ve açık bir hata kodu içerir.
Desteklenen her API uç noktası için bir kablo olmak üzere beş kablolu merkezi bir ünite

Uç noktalar genel bakışta

Bir sağlayıcı hangi OpenAI tarzı yolları gerçekten uygular? İşte bu API için kısa liste. Temel URL: https://api.uncensoredendpoint.com/v1. Yetkilendirme, her çağrıda bearer anahtarı gerektirir.

Yöntem ve yolAmaç
POST /v1/chat/completionsSohbet istekleri, akış, araçlar, JSON modu
POST /v1/responsesDaha yeni Responses tarzı istek formatı
GET /v1/modelsModeli listeler; ID uncensored şeklindedir
GET /v1/dashboard/billing/credit_grantsOpenAI tarzı yapıda bakiye
GET /v1/balanceBasit formatta bakiye

Bu kapsamın tamamıdır. Tabloda yer almayan hiçbir şey sunulmaz. Kodu yazmadan önce planlama yapabilmeniz için çalışan istekleri ve eksik olanların listesini içeren aşağıdaki bölümleri okuyun.

Sohbet tamamlamaları

Bu, istemcilerin çoğunun kullandığı uç noktadır. Herhangi bir OpenAI SDK'sını temel URL'e yönlendirin ve model adı olarak uncensored kullanın.

from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "List three uses of a webhook."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

Desteklenen parametreler arasında stream, tools, tool_choice, response_format (json_object ile) ve örneklem seti yer alır: temperature, top_p, stop, seed ve ceza parametreleri. max_tokens isteğe bağlıdır, çünkü bir tamamlama işlemi 100.000 tokenlık bağlam penceresinde kalan her şeyi kullanabilir.

stream: true ile yanıt, sunucu tarafından gönderilen olaylar olarak gelir ve kullanım bilgisi sona eklenir, böylece token sayılarını hala günlüğe kaydedebilirsiniz.

Çoklu dönüş sohbetleri

API konuşma durumunu tutmaz. Çoklu dönüş sohbeti için her seferinde tam mesaj listesini gönderirsiniz: önce sistem mesajı, ardından sırayla kullanıcı ve asistan dönüşleri. Bu, her dönüşte girdi tokenlarının arttığı ve maliyetin yükseldiği anlamına gelir, bu nedenle konuşma uzadığında eski dönüşleri kısaltın veya özetleyin. Pencere, prompt ve tamamlama için 100.000 token'dır; bu çoğu sohbet için yeterlidir ancak yapıştırılan belgelerle kolayca doldurulabilir.

Yanıtlar, modeller ve bakiye

Yanıtlar

Daha yeni OpenAI örnekleri /v1/responses endpoint'ini kullanır. Bu endpoint burada da mevcuttur, bu nedenle bu formatta yazılmış kodun yeniden yazılmasına gerek yoktur.

curl https://api.uncensoredendpoint.com/v1/responses \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "input": "Write a haiku about caching."}'

İstemcinizin beklediği şeyi kullanın. Sıfırdan başlıyorsanız, sohbet tamamlamaları en geniş araç desteğine sahiptir.

Modeller ve bakiye

Anahtarınızın çalıştığını kontrol etmek için modelleri listele. Hizmet tek model çalıştırdığı ve tedarikçiler arasında bir yönlendirici olmadığı için tek bir giriş görmelisiniz: uncensored.

curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"

# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"

# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"

Her yanıtta X-Balance-USD başlığında da bakiye alırsınız; bu, ekstra bir istek olmadan uygulamanızda düşük bakiye uyarısı için kullanışlıdır. Diğer başlıklar arasında destek soruları için X-Request-Id ve ayrıca X-RateLimit-Limit-Requests ile X-RateLimit-Limit-Concurrency yer alır.

Araçlar ve JSON modu uygulamada

Bir sohbet uç noktasını bir ürün geliştirmeye uygun hale getiren iki özellik vardır. Araç çağırma, modelin kodunuzun bir işlevi çalıştırmasını sağlar. JSON modu, modelin ayrıştırılabilir bir çıktı döndürmesini sağlar. İkisi de standart istek alanlarını kullanır.

Bir araç çağrısı şöyle görünür. Model bir tool_calls girişi döndürür, işlevi çalıştırırsınız ve sonucu role: "tool" ile bir mesaj olarak geri gönderirsiniz.

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Current weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)

msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)

JSON modu için response_format={"type": "json_object"} ekleyin ve istemde JSON istediğinizi belirtin, mümkünse beklediğiniz anahtarlarla. Her zaman bir try bloğu içinde ayrıştırın: hiçbir model her çağrıda şemanızı garanti etmez, bu yüzden sonuca güvenmeden önce sonucu doğrulayın.

Mevcut bir OpenAI projesini taşıma

Uygulamanız zaten bir OpenAI SDK'sı kullanıyorsa, geçiş işlemi üç düzenleme ve yeni bir kütüphane gerektirmez. Çoğu SDK aynı iki ortam değişkenini okur, bu nedenle kodda genellikle hiçbir değişiklik yapmanıza gerek kalmaz.

export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEY
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);

Ardından model adlarını (örneğin bir GPT model kimliğini) uncensored ile değiştirmek için kodunuzda arama yapın; hizmetin tek bir modeli vardır. Embeddings, görüntü veya ses çağrılarını kaldırın ve bunları başka bir sağlayıcıya yönlendirin. Kısa bir kontrol listesi tutun: base URL değiştirildi, model adı değiştirildi, anahtar bir ortam değişkeninde depolandı ve repository'de değil, 429 hataları için yeniden deneme mantığı eklendi ve bakiye başlığına dayalı düşük bakiye uyarısı yapıldı. Anahtar kurulumu için sansürsüz bir AI API anahtarı nasıl alınır bölümüne bakın. Ardından tek bir test isteği çalıştırın ve gerçek trafiğe geçmeden önce X-Balance-USD başlığının döndüğünden emin olun.

Sunulanlar dışındakiler

Boşlukları bilmek bir gün hata ayıklamadan kurtarır. Bu API yalnızca metin içindir. Bu OpenAI uç noktaları mevcut değildir:

  • Görüntü ve vizyon üretimi. Görüntü oluşturma veya düzenleme yoktur.
  • Ses. Metinden sese veya sesten metne yok.
  • Video. Sunulmuyor.
  • Embeddings. Geri getirme (retrieval) oluşturuyorsanız, ayrı bir embedding hizmetine ihtiyacınız vardır.
  • İnce ayar. Hizmette eğitim yapamazsınız.

Bu yollara yapılan çağrılar başarısız olur, bu nedenle bunları ortak istemci yapılandırmanızdan çıkarın. Tipik bir kurulum, bu API'yi sohbet için kullanırken embeddings için başka bir sağlayıcı kullanır ve uygulamanız görev başına base URL'i seçer.

Limitler, hatalar ve yeniden denemeler

Tam bir anahtar eşzamanlı 8 istek ve dakikada 300 istek yapmanıza izin verir. Deneme anahtarı dakikada 60 istek ve eşzamanlı 2 istek yapmanıza izin verir. Maksimum gövde boyutu 8 MB'tır. Bir limiti aştığınızda, hangi limitin aşıldığını söyleyen bir hata kodu ile HTTP 429 alırsınız: dakikada istekler için rate_limited, aynı anda çok fazla istek için concurrency. Geçici aşırı yüklenme durumunda da 429 yanıtı alırsınız, bu durumda Retry-After: 5 başlığı döner.

İnsanları şaşırtan bir detay var: akışlı bir istek, akış bitene kadar eşzamanlılık slotunu tutar, bu nedenle yavaş okuyucular kullanılabilir kota sınırını azaltır. Bunu basit bir yeniden deneme sarmalayıcısı halleder:

import time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")

def ask(prompt, tries=4):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (i + 1))
    raise RuntimeError("still rate limited")

Başarısız veya reddedilen istekler için ücret alınmaz, bu nedenle hatalarda yeniden deneme yapmak ek maliyet gerektirmez. Toplu işler için, yeniden denemelere güvenmek yerine tam anahtarınızda işçi havuzunuzu 8 ile, deneme anahtarınızda 2 ile sınırlayın. Sabit bir havuz, düşünülmesi daha kolaydır ve bir yavaş akışın diğerlerini kaynak açlığına düşürmesini engeller.

Maliyet ve erişim

Fiyatlandırma, ön ödemeli kredi ile, abonelik veya sona erme olmaksızın, 1M girdi token başına $0,15 ve 1M çıktı token başına $0,50'dir. $20 ile $500 arasında herhangi bir tam tutarla kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile bakiye yükleyebilirsiniz. Daha büyük yüklemeler bonus ekler: $50'den itibaren +%5, $100'den itibaren +%10, $200'den itibaren +%15. fiyatlandırma sayfası adresine bakın.

Denemek için Google veya e-posta ile kaydolun, ardından API anahtarı sayfası üzerinde tek tıkla $0,50 deneme kredisi talep edin. belgeler her parametreyi kapsar ve uç nokta genel bakışı hizmetin ne olduğunu açıklar: yasal yetişkin kullanımı için açık ağırlıklı tek bir model, içerik reddi yok ve reşit olmayanlar içeren cinsel içerik için kesin yasak.

Sorular ve cevaplar

Akış ve fonksiyon çağırma destekleniyor mu?

Evet. Kullanım bilgisi sona eklenmiş sunucu tarafından gönderilen olaylar için stream: true ve fonksiyon çağırma için tool_choice ile araçları kullanın.

Bir embeddings uç noktası var mı?

Hayır. Hizmet yalnızca metin sohbeti içindir, bu nedenle embeddings için başka bir sağlayıcı kullanın.

Bakiyemi nasıl kontrol ederim?

GET /v1/balance veya OpenAI tarzı credit_grants yolunu çağırın veya herhangi bir yanıtta X-Balance-USD başlığını okuyun.

Hız limitine (rate limit) ulaştığımda ne olur?

HTTP 429 yanıtını, code alanı rate_limited veya concurrency olan bir hata ile alırsınız. Bekleyip yeniden deneyin; geçici aşırı yüklenme durumunda Retry-After başlığı 5 saniye değerini verir.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.

API anahtarı alDokümantasyonu oku