TR ▾
API anahtarı al

Tek API: Hızlı Başlangıç Kılavuzu

Tek bir yapılandırma değişikliğiyle sansürsüz LLM API'mizi entegre edin. Tak-çalıştır uyumluluğu, temel URL ve API anahtarını değiştirdikten sonra mevcut kodunuzu korumanız gerektiği anlamına gelir.

Temel URL & Kimlik Doğrulama

İstemcinizi özel OpenAI uyumlu API uç noktamıza yönlendirerek başlayın. Standart kimlik doğrulama başlıklarını kullandığından, yapılandırmanızda yalnızca iki değeri değiştirmeniz yeterlidir.

Temel URL https://api.onekeyllmapi.com/v1 şeklindedir. Benzersiz API anahtarınızı kayıt sayfasında oluşturun. Başlamak için kart gerekmez ve anahtar kayıt sırasında hemen gösterilir. Anahtarı güvende tutun; hizmete yapılan tüm isteklerde kimlik doğrulaması yapar.

Temel Tamamlama

Doğrudan yanıt almak için basit bir metin istemi gönderin. Bu, modelin yasal yetişkin kullanımı için içerik reddi olmadan metin döndürdüğü, yaratıcı veya kısıtlamasız görevler için ideal olan geliştiriciler için AI API teklifimizin özüdür.

  • Model Kimliği: uncensored
  • Uç Nokta: POST /v1/chat/completions
  • Bağlam: 100.000 token

İlk isteğinizi bu örnekle yapın:

curl https://api.onekeyllmapi.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

Hizmetimizle etkileşim kurmak için resmi OpenAI Python kütüphanesini kullanın. Gerekli tek değişiklikler base_url ve api_key'dir. Bu, mevcut mantığınızın değişiklik olmadan çalışmasını sağlar.

  • pip install openai ile yükleyin
  • Ortam değişkenlerini ayarlayın veya istemci başlatmasında doğrudan iletin
  • chat.completions.create()'yi olduğu gibi çağırın

İstemciyi şu şekilde yapılandırın:

from openai import OpenAI

client = OpenAI(base_url="https://api.onekeyllmapi.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 Kullanımı

Standart OpenAI Node paketini kullanarak JavaScript veya TypeScript projelerine entegre edin. İstemciyi URL'mize yönlendirin ve anahtarınızı sağlayın. Bu yaklaşım, herhangi bir OpenAI uyumlu istemci yapısıyla uyumluluğu korur.

  • npm install openai ile yükleyin
  • Özel temel URL ile başlatın
  • Standart async/await kalıplarını kullanın

Örnek başlatma:

import OpenAI from "openai";

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

Daha düşük algılanan gecikme için yanıtı token token alın. akış api'imiz Sunucu Tarafı Olayları (SSE) destekler, böylece çıktı oluşturulurken görüntüleyebilirsiniz. Bu, sohbet arayüzleri veya gerçek zamanlı uygulamalar için kullanışlıdır.

  • İsteğinizde stream: true ayarlayın
  • İstemcide SSE akışını ayrıştırın
  • Kısmi token'ları verimli şekilde işleyin

Kodunuzda akışı etkinleştirin:

stream = 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 & Bağlam

Sağlam entegrasyonlar oluşturmak için kısıtlamaları anlayın. API 100k bağlam api penceresi destekler; bu da uzun belgeleri veya konuşmaları mümkün kılar. İstekler 8 MB gövde boyutu ile sınırlıdır.

Yaygın hatalar arasında geçersiz anahtarlar için 401, ön ödemeli kredi tükendiğinde 402 ve dakikada 300 isteği aşmak için 429 yer alır. Kullandıkça öde kredisi hiçbir zaman süresi dolmaz ve 10 $'dan başlayan bakiye yükleyebilirsiniz. Fonksiyon yürütme için fonksiyon çağırma desteklenir.

API özellikleri

Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.

ÖğeDeğer
BiçimOpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır
Model kimliğiuncensored
Base URLhttps://api.onekeyllmapi.com/v1
Kimlik doğrulamaAuthorization: Bearer YOUR_KEY
Uç noktalarPOST /v1/chat/completions · GET /v1/models
Bağlam penceresi100.000 token (girdi + çıktı)
Fonksiyon çağırmaevet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak
JSON moduresponse_format: {"type": "json_object"}
Parametrelertemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Akışevet — server-sent events; son parça token kullanımını içerir
Maksimum çıktı100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok)
İstek boyutuen fazla 8 MB
Yanıt başlıklarıX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Hız limitianahtar başına dakikada 300 istek
Eşzamanlılıkanahtar başına aynı anda 8 istek
YüklemeUSDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar
Faturalamaön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz
Geçerliliködenen kredinin süresi dolmaz, abonelik yok
Bonus$50'dan itibaren +%5, $100'dan itibaren +%10
Fiyat1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00
Ücretsiz deneme$0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300)
Anahtarlarhesap başına bir aktif anahtar; yenisi eskisinin yerini alır
GirişGoogle veya e-posta ve şifre
İçerikyetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir

Hata kodları

Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.

KodTürAnlamı
400bad_requestgeçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun
401missing_key · invalid_key · key_revokedanahtar yok, yanlış veya değiştirilmiş
402no_creditkredi bitti — yükleyin, hemen devam eder
403content_blockedreşit olmayanları içeren cinsel içerik — reddedildi, ücret yok
404not_foundbilinmeyen uç nokta
413request_too_largegövde 8 MB'tan büyük
429rate_limited · concurrencydakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin
503upstream_busymodel meşgul — birkaç saniye sonra tekrar deneyin

Sorular ve cevaplar

Bu bir OpenAI modeli mi?

Hayır. Kendi GPU sunucularımızda çalışan tek bir özel sansürsüz büyük dil modeli sunuyoruz. GPT, Claude veya başka bir satıcının modeli değil, ancak API yapılarıyla uyumludur.

Fiyatlandırma nasıl çalışır?

Aylık ücreti olmayan, kullandıkça öde modelini kullanıyoruz. Giriş token'ları 1M başına $0,25, çıktı token'ları 1M başına $1,00'dır. Ön ödemeli kredi hiç sona ermez ve $0,50'lik deneme kredisi ile başlayabilirsiniz.

Bağlam penceresi boyutu nedir?

API, hem istem hem de tamamlama için 100.000 token'lık bir bağlam penceresi destekler. Bu, tek bir istek içinde kapsamlı sohbetlere veya uzun belge işleme imkânı verir.

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

Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı budur.