URL Dasar dan Autentikasi
API kami berada di https://api.huggingfacellmapi.com/v1. Anda mengautentikasi menggunakan token Bearer yang dikirim di Authorization header. Buat kunci Anda secara instan melalui Dapatkan kunci API halaman menggunakan Google atau email. Simpan kunci ini dengan aman; siapa pun yang memilikinya dapat menghabiskan kredit prabayar Anda. Jika Anda kehilangannya, buat kunci baru untuk menggantikan kunci aktif lama. Tidak diperlukan nomor telepon untuk memulai.
Permintaan Pertama dengan cURL
Kirimkan payload JSON mentah untuk menguji endpoint segera. Gunakan ID model uncensored untuk melewati filter standar. Perintah cURL berikut menunjukkan permintaan generasi teks dasar.
curl https://api.huggingfacellmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize the release notes for version three point zero five"}]
}'Ini mengembalikan objek JSON yang berisi teks yang dihasilkan. Periksa choices array untuk konten sebenarnya. Jika Anda menerima kesalahan 401, verifikasi kunci Anda benar dan aktif.
Integrasi SDK Python
Gunakan resmi openai Library Python untuk antarmuka yang bersih. Arahkan klien ke URL dasar kami dan atur kunci API Anda. Pendekatan ini menangani percobaan ulang dan parsing JSON secara otomatis.
from openai import OpenAI
client = OpenAI(base_url="https://api.huggingfacellmapi.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)Instal paket melalui pip. Anda kemudian dapat memanggil endpoint chat completions seperti halnya dengan OpenAI. Objek respons memberikan Anda akses ke penggunaan token dan alasan penyelesaian.
Pengaturan Klien Node.js
Pengembang JavaScript dapat menggunakan openai Paket Node. Konfigurasikan klien dengan URL dasar spesifik kami. Ini memastikan semua permintaan dialihkan melalui server tanpa sensor kami.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.huggingfacellmapi.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);Jalankan cuplikan ini di lingkungan Node Anda. Ini mendemonstrasikan panggilan sinkron sederhana. Anda dapat mengintegrasikannya ke dalam rute Express atau fungsi serverless dengan mudah.
Respons Streaming
Aktifkan streaming dengan mengatur stream: true. Server mengirim Server-Sent Events (SSE) yang berisi token parsial. Ini mengurangi latensi persepsi bagi pengguna akhir.
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)Parse setiap potongan saat tiba. Potongan terakhir berisi penggunaan token total untuk permintaan. Ini berguna untuk membangun antarmuka obrolan yang mengetik respons secara real-time.
Batas, Error, dan Konteks
Jendela konteks adalah 100.000 token untuk prompt dan completion digabungkan. Anda dapat meminta hingga 16.000 token output. Error seperti 401 menunjukkan kunci tidak valid, sedangkan 402 berarti kredit tidak cukup. Batas laju membatasi Anda hingga 300 permintaan per menit. Permintaan yang melebihi ukuran 8 MB akan ditolak. Error selama pemrosesan tidak mengonsumsi kredit Anda.