Acestep iş akışları için hızlı başlangıç

Önkoşullar: API Anahtarınızı Alın

İstek göndermeden önce geçerli bir API anahtarına ihtiyacınız vardır. acestep.cc üzerinde API anahtarını al sayfasını ziyaret edin. Google ile devam et seçeneğiyle veya e-posta ve şifre hesabı oluşturarak kayıt olabilirsiniz. Telefon numarası gerekmez. Kayıt olduktan sonra API anahtarınız hemen görüntülenir. Bu anahtarı kopyalayın; sonraki tüm isteklerde kimlik doğrulaması için kullanacaksınız. Krediniz yoksa bakiye yüklemeniz gerekir. $10 ile $500 arasındaki tutarlar için yalnızca kripto para birimi ödemelerini kabul ediyoruz (TRC20 üzerinde USDT veya Base üzerinde USDC). Yeni hesaplara, kart gerekmeden başlamak için 7 gün geçerli $0.50 deneme kredisi verilir. Anahtarınızı hız limitleri ve token tüketimi karşısında kullanımınızı doğruladığı için güvende tutun.

Kurulum

API, standart OpenAI uyumlu protokolü kullanır. İstediğiniz dil için resmi OpenAI SDK'larını veya herhangi bir HTTP istemcisini kullanarak API ile etkileşim kurabilirsiniz. Python için openai paketini yükleyin. Node.js için openai yükleyin. Özel temel URL'leri destekleyen SDK'nın güncel bir sürümünü kullandığınızdan emin olun. Hizmetimizin temel URL'si https://api.acestep.cc/v1 şeklindedir. Bu, temel URL'yi ve API anahtarını değiştirerek, OpenAI uç noktalarını bekleyen mevcut boru hattı kodunu yeniden kullanmanızı sağlar. İsteklerinizde belirtmeniz gereken model kimliği uncensored'dir. Bu model, yasal yetişkinlere yönelik, kurgusal veya tartışmalı konularda en az reddetme için ayarlanmış açık ağırlıklı bir LLM'dir; bu da içerik filtrelerinin geçerli yaratıcı çıktıları engellemeyeceği yaratıcı boru hatları için idealdir.

Temel İstek: Metin Üret

/v1/chat/completions uç noktasına sistem isteminizi ve kullanıcı mesajlarınızı göndererek bir POST isteği yapın. Model, oluşturulan metni döndürür. model parametresinin uncensored olarak ayarlandığından emin olun. Yaratıcılığı temperature ve top_p ile kontrol edebilirsiniz. Bağlam penceresi toplamda 100.000 tokena (istem + tamamlama) kadar destekler. Her istek için maksimum çıktı 32.000 tokendır; max_tokens belirtmezseniz bu değer 2.048 token olur. Hatalar ve reddetmeler krediden düşmez, ancak başarılı token üretimi düşer. Bu uç nokta; konuşma veya görüntü oluşturma API'lerine aktarmadan önce metin verilerini işlemek veya senaryo, altyazı oluşturmak için kullanılabilir.

Akış Yanıtları

Gerçek zamanlı güncellemeler için isteğinize stream: true ekleyin. API, Sunucu Tarafından Gönderilen Olaylar (SSE) döndürür. Her parça kısmi metin içerir. Token kullanım ayrıntıları akışın son parçasında sağlanır. Bu, metin oluşturulurken görüntüleyen uygulamalar için metnin oluşturulması sırasında algılanan gecikmeyi iyileştirmek için kullanışlıdır. İstemcinizin SSE'yi doğru şekilde işlediğinden emin olun. Akış, tokenların geldiği şekilde işlenmesine olanak tanır; bu, iş akışınızdaki uzun formatlı içerik üretimi için faydalıdır. Akışın fiyatlandırmayı veya token limitlerini değiştirmediğini unutmayın; oluşturulan toplam tokenlar için hala ücretlendirilirsiniz.

Fonksiyon Çağırma

API, modelin tanımladığınız araçlara dayalı olarak yapılandırılmış veri oluşturmasına olanak tanıyan fonksiyon çağırma özelliğini destekler. İşlevlerinizi tools parametresinde tanımlayın. tool_choice parametresini auto veya belirli bir işlev adına ayarlayın. Model, uygun olduğunda bir fonksiyon çağırma nesnesi ile yanıt verecektir. Bu, metinden yapılandırılmış veri çıkarmak veya aşağı akış API çağrıları için girdileri hazırlamak için değerlidir. Ayrıca response_format parametresini {"type": "json_object"} olarak ayarlayarak JSON çıktısını zorlayabilirsiniz. Bu, modelin güvenilir entegrasyon için kritik olan geçerli JSON döndürmesini sağlar. Bu özellikleri kullanarak metin işleme adımlarınızın güvenilirliğini artırın.

Fiyatlandırma ve Limitler

Fiyatlandırma, 1M giriş tokenı başına $0.25 ve 1M çıktı tokenı başına $1.00'dır. Kredi ön ödemelidir ve asla sona ermez. Hatalar ücretsizdir. Hız limitleri anahtar başına dakikada 300 istek ve anahtar başına aynı anda 8 eşzamanlı istektir. Maksimum istek gövdesi boyutu 8 MB'tır. Hız limitini aşarsanız 429 hatası alırsınız. 401 hatası geçersiz veya süresi dolmuş bir anahtarı gösterir. 402 hatası yetersiz kredi anlamına gelir. Krediler için iade yapılmaz; itirazlar Destek sayfası üzerinden ele alınır. Hesap başına bir aktif anahtar izin verilir; yeni bir anahtar oluşturmak eski anahtarı değiştirir. İş akışınızın yeniden deneme mantığını tasarlarken bu limitleri göz önünde bulundurun.

cURL

Copycurl https://api.acestep.cc/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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)