Panduan Cepat untuk Pipa Acestep

Prasyarat: Dapatkan Kunci API Anda

Sebelum membuat permintaan, Anda memerlukan kunci API yang valid. Kunjungi halaman Dapatkan Kunci API di acestep.cc. Anda dapat mendaftar menggunakan Lanjutkan dengan Google atau dengan membuat akun email dan kata sandi. Tidak diperlukan nomor telepon. Setelah terdaftar, kunci API Anda ditampilkan segera. Salin kunci ini; Anda akan menggunakannya untuk mengautentikasi semua permintaan selanjutnya. Jika Anda tidak memiliki saldo, Anda perlu mengisi ulang. Kami hanya menerima pembayaran kripto (USDT pada TRC20 atau USDC pada Base) untuk jumlah antara $10 dan $500. Akun baru menerima $0,50 saldo uji coba yang berlaku selama 7 hari, tanpa perlu kartu untuk memulai. Jaga kunci Anda agar aman, karena kunci tersebut mengautentikasi penggunaan Anda terhadap batas laju dan konsumsi token.

Instalasi

API menggunakan protokol standar yang kompatibel dengan OpenAI. Anda dapat berinteraksi dengannya menggunakan SDK resmi OpenAI untuk bahasa pilihan Anda atau klien HTTP apa pun. Untuk Python, instal paket openai. Untuk Node.js, instal openai. Pastikan Anda menggunakan versi SDK terbaru yang mendukung URL dasar kustom. URL dasar untuk layanan kami adalah https://api.acestep.cc/v1. Ini memungkinkan Anda menggunakan kembali kode pipeline yang ada yang mengharapkan endpoint OpenAI, hanya dengan mengganti URL dasar dan kunci API. ID model yang harus Anda tentukan dalam permintaan Anda adalah uncensored. Model ini adalah LLM bobot terbuka yang disesuaikan untuk penolakan minimal pada topik dewasa yang sah, fiksi, atau kontroversial, menjadikannya ideal untuk pipeline kreatif di mana filter konten mungkin memblokir output kreatif yang valid.

Permintaan Dasar: Hasilkan Teks

Kirimkan permintaan POST ke /v1/chat/completions dengan prompt sistem dan pesan pengguna Anda. Model akan mengembalikan teks yang dihasilkan. Pastikan Anda menetapkan parameter model ke uncensored. Anda dapat mengontrol kreativitas dengan temperature dan top_p. Jendela konteks mendukung hingga 100.000 token total (prompt + penyelesaian). Output maksimum per permintaan adalah 32.000 token, atau 2.048 jika Anda tidak menentukan max_tokens. Kesalahan dan penolakan tidak mengonsumsi saldo, tetapi generasi token yang berhasil melakukannya. Gunakan endpoint ini untuk menghasilkan skrip, keterangan, atau memproses data teks sebelum menyampaikannya ke modalitas lain seperti API suara atau generasi gambar.

Respons Streaming

Untuk pembaruan waktu nyata, tetapkan stream: true dalam permintaan Anda. API mengembalikan Server-Sent Events (SSE). Setiap bagian berisi teks parsial. Detail penggunaan token disediakan dalam bagian terakhir dari aliran. Ini berguna untuk aplikasi yang menampilkan teks saat dihasilkan, meningkatkan latensi yang dirasakan bagi pengguna. Pastikan klien Anda menangani SSE dengan benar. Aliran memungkinkan Anda memproses token saat tiba, yang bermanfaat untuk generasi konten panjang dalam pipa Anda. Ingat bahwa streaming tidak mengubah harga atau batas token; Anda masih dibayar untuk total token yang dihasilkan.

Pemanggilan Fungsi

API mendukung pemanggilan fungsi, memungkinkan model mengeluarkan data terstruktur berdasarkan alat yang Anda tentukan. Tentukan fungsi Anda dalam parameter tools. Tetapkan tool_choice ke auto atau nama fungsi tertentu. Model akan merespons dengan objek panggilan fungsi jika sesuai. Ini berharga untuk mengekstrak data terstruktur dari teks atau menyiapkan input untuk panggilan API lanjutan. Anda juga dapat memaksa output JSON dengan menetapkan response_format ke {"type": "json_object"}. Ini memastikan model mengembalikan JSON yang valid, yang sangat penting untuk integrasi yang andal ke dalam pipa otomatis Anda. Gunakan fitur-fitur ini untuk meningkatkan keandalan langkah pemrosesan teks Anda.

Harga dan Batas

Harga adalah $0.25 per 1M token input dan $1.00 per 1M token output. Saldo prabayar dan tidak pernah kedaluwarsa. Kesalahan gratis. Batas laju adalah 300 permintaan per menit per kunci dan 8 permintaan paralel secara bersamaan per kunci. Ukuran badan permintaan maksimum adalah 8 MB. Jika Anda melebihi batas laju, Anda menerima kesalahan 429. Kesalahan 401 menunjukkan kunci tidak valid atau kedaluwarsa. Kesalahan 402 berarti Anda memiliki saldo tidak cukup. Pengembalian dana tidak diterbitkan untuk saldo; sengketa ditangani melalui halaman Dukungan. Satu kunci aktif diizinkan per akun; menghasilkan kunci baru menggantikan kunci lama. Pertimbangkan batas-batas ini saat merancang logika percobaan ulang pipeline Anda.

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);

Streaming

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)