URL Asas dan Pengesahan
API kami terletak di https://api.huggingfacellmapi.com/v1. Anda mengesahkan menggunakan token Bearer yang dihantar dalam Authorization header. Jana kunci anda serta-merta melalui Dapatkan kunci API halaman menggunakan Google atau e-mel. Simpan kunci ini dengan selamat; sesiapa sahaja yang memilikinya boleh menghabiskan kredit pra-dibayar anda. Jika anda kehilangannya, jana kunci baharu untuk menggantikan kunci aktif lama. Tiada nombor telefon diperlukan untuk memulakan.
Permintaan Pertama dengan cURL
Hantar beban kerja JSON mentah untuk menguji hujung serta-merta. Gunakan ID model uncensored untuk memintas penapis standard. arahan cURL berikut menunjukkan permintaan penjanaan teks asas.
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 mengandungi teks yang dijana. Periksa choices array for the actual content. If you receive a 401 error, verify your key is correct and active.
Integrasi SDK Python
Gunakan rasmi openai Python library for a clean interface. Point the client to our base URL and set your API key. This approach handles retries and JSON parsing automatically.
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)Pasang pakej melalui pip. Anda kemudian boleh memanggil endpoint penyelesaian sembang seperti yang anda lakukan dengan OpenAI. Objek respons memberikan anda akses kepada penggunaan token dan sebab-sebab penamatan.
Persediaan Pelanggan Node.js
Pembangun JavaScript boleh menggunakan openai Pakej Node. Konfigurasikan klien dengan URL asas khusus kami. Ini memastikan semua permintaan dialihkan melalui pelayan 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 dalam persekitaran Node anda. Ia menunjukkan panggilan sinkron mudah. Anda boleh mengintegrasikannya ke dalam laluan Express atau fungsi serverless dengan mudah.
Respons Streaming
Aktifkan aliran dengan menetapkan stream: true. Pelayan menghantar Acara Dihantar Pelayan (SSE) yang mengandungi token separa. Ini mengurangkan latensi yang dirasakan untuk 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)Uraikan setiap pecahan apabila ia tiba. Pecahan akhir mengandungi penggunaan token jumlah untuk permintaan tersebut. Ini berguna untuk membina antara muka sembang yang menaip respons secara masa nyata.
Had, Ralat, dan Konteks
Tingkap konteks adalah 100,000 token untuk gabungan prompt dan penyelesaian. Anda boleh meminta sehingga 16,000 token output. Ralat seperti 401 menunjukkan kunci tidak sah, manakala 402 bermakna kredit tidak mencukupi. Had kadar mengehadkan anda kepada 300 permintaan setiap minit. Permintaan melebihi 8 MB dalam saiz akan ditolak. Ralat semasa pemprosesan tidak menggunakan kredit anda.