Dokumentasi API Hermes: Memulai Cepat

Instalasi dan Setup

API hermes berfungsi dengan klien apa pun yang menggunakan format OpenAI. Anda memerlukan URL dasar dan kunci API. Buat akun melalui Google atau email di halaman Dapatkan kunci API. Sistem menampilkan kunci Anda segera. Tidak diperlukan nomor telepon. Anda menerima kredit percobaan $0.50 selama tujuh hari. Isi ulang nanti hanya dengan kripto.

• URL Dasar: HTTPS://api.apihermes.cc/v1
• Header Auth: Authorization: Bearer YOUR_API_KEY
• ID Model: uncensored

Instal SDK pilihan Anda dan atur URL dasar. Endpoint mengharapkan parameter penyelesaian chat standar. Jaga kunci Anda tetap aman. Satu kunci menggantikan kunci sebelumnya jika Anda membuat yang baru.

Permintaan Penyelesaian Obrolan Dasar

Permintaan dasar mengirim pesan dan menerima respons teks. ID model adalah tidak disensor. Model ini menangani konten dewasa yang sah tanpa penolakan. Anda membayar per token yang digunakan. Kesalahan dan penolakan tidak dikenakan biaya. Jendela konteks menampung 100.000 token secara total.

Strukturkan permintaan Anda dengan pesan sistem dan pesan pengguna. API mengembalikan completion. Anda dapat mengatur max_tokens untuk mengontrol panjang output. Batas output default adalah 2.048 token. Anda dapat meningkatkannya menjadi 16.000 token per permintaan. Streaming bekerja melalui SSE. Function calling tersedia. Mode JSON didukung.

Copycurl https://api.apihermes.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a GET request for the user endpoint"}]
  }'

Badan permintaan dibatasi hingga 8 MB. Batas laju adalah 300 permintaan per menit. Konkuensi adalah delapan permintaan sekaligus. Logika retry menangani kelebihan beban server dengan baik.

Respons Streaming dengan SSE

Mengirimkan token saat dihasilkan. Server mengirim Server-Sent Events. Setiap chunk berisi teks parsial. Chunk terakhir mencakup statistik penggunaan token. Pendekatan ini mengurangi latensi yang dirasakan untuk respons panjang. Ini sangat ideal untuk antarmuka chat. Anda harus menangani stream dengan benar. Putus koneksi dapat terjadi. API tidak menjamin urutan pengiriman di luar stream itu sendiri.

Atur parameter stream menjadi true. Uraikan baris data. Gabungkan konten. Periksa finish_reason untuk penyelesaian. Model uncensored bekerja dengan SDK yang kompatibel dengan OpenAI. Konfigurasikan klien untuk menangani SSE. Pantau jumlah token. URL dasar tetap sama. Autentikasi identik. Tidak perlu pengaturan tambahan.

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)

Kesalahan muncul dalam aliran. Tangani dengan menutup koneksi. Kredit prabayar hanya dipotong untuk token yang selesai. Ini menghemat uang selama gangguan. Anda tidak pernah membayar untuk output sampah parsial. Sistemnya transparan.

Menggunakan Function Calling dan Alat

Pemanggilan fungsi memungkinkan model mengeksekusi kode atau alat. Tentukan alat dalam badan permintaan. Model mengembalikan panggilan alat. Anda mengeksekusi alat. Anda mengirimkan hasilnya kembali. Model menghasilkan respons akhir. Ini memungkinkan alur kerja kompleks. Ini bukan sekadar pembungkus obrolan. API mendukung alat dan tool_choice. Gunakan ini untuk agen atau otomatisasi.

Strukturkan array tools. Sertakan nama, deskripsi, dan parameter. Model memutuskan kapan memanggil alat. Anda harus mengurai argumennya. Eksekusi fungsi. Luarkan output ke percakapan. Model melanjutkan. Siklus ini berulang hingga jawaban akhir. Jendela konteks melacak semua interaksi alat. Pantau penggunaan token. Biaya bertambah dengan output alat. Pantau penggunaan dalam chunk terakhir.

Copyfrom openai import OpenAI

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

Model tanpa sensor menangani skema alat yang beragam. Model ini tidak menolak berdasarkan konten. Gunakan ini untuk roleplay atau tugas teknis. API-nya andal. Bebas error. Sistem pra-bayar memastikan keadilan. Anda mengendalikan aliran. URL dasar konsisten. Otentikasi sederhana.

Mode JSON dan Parameter

Mode JSON memaksa model untuk menghasilkan JSON yang valid. Atur response_format ke json_object. Ini berguna untuk data terstruktur. Model menghindari pembungkus markdown. Model mengembalikan JSON mentah. Gunakan ini untuk parsing. Ini meningkatkan keandalan. Jendela konteks masih berlaku. Anda membayar untuk token. Model uncensored menghormati format. Model tidak menolak berdasarkan konten.

Parameter termasuk suhu, top_p, stop, seed, presence_penalty, dan frequency_penalty. Suhu mengontrol keacakan. Top_p mengontrol keragaman. Urutan hentikan menghentikan generasi. Seed memastikan reproduktibilitas. Kehadiran dan frekuensi penalti menyesuaikan penggunaan token. Atur ini untuk menyempurnakan output. API mendukung semua parameter standar. Gunakan untuk menyetel respons. URL dasar tetap sama. Autentikasi identik.

Copyimport OpenAI from "openai";

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

Kesalahan ditangani melalui kode status HTTP. 401 berarti kunci tidak valid. 402 berarti tidak ada kredit. 429 berarti batas laju. Tangani ini dalam kode Anda. Kredit prabayar hanya dikurangi untuk token yang berhasil. Ini menjamin keadilan. Anda tidak pernah membayar untuk output parsial. Sistemnya transparan. Model uncensored andal. Gunakan untuk tugas hukum apa pun.

Penanganan Kesalahan dan Batasan Laju

API mengembalikan kode status HTTP standar. 401 menunjukkan kunci API tidak valid. 402 menunjukkan kredit prabayar tidak cukup. 429 menunjukkan batas laju. Batasnya adalah 300 permintaan per menit. Konsumsinya adalah delapan permintaan sekaligus. Badan permintaan dibatasi hingga 8 MB. Tangani error ini dengan baik. Coba lagi dengan backoff eksponensial. Model uncensored tidak menolak konten yang sah. Error gratis. Anda tidak membayar untuk permintaan yang gagal. Kredit prabayar aman. Tidak pernah kedaluwarsa. Gunakan halaman Dukungan untuk pengisian ganda. Hanya kripto. USDT atau USDC. Bonus berlaku.