API Hermes: Ganti klien Anda dalam tiga baris

Instal SDK OpenAI

Karena endpoint kami kompatibel dengan OpenAI, Anda dapat menggunakan SDK resmi yang sudah Anda kenal. Pendekatan ini memungkinkan Anda beralih dari vendor lain tanpa menulis ulang logika aplikasi Anda. Kami mendukung paket openai standar untuk lingkungan Python dan Node.js.

Pastikan Anda menggunakan versi SDK terbaru untuk menjamin kompatibilitas dengan fitur streaming dan pemanggilan fungsi. Perpustakaan klien menangani serialisasi JSON dan transportasi HTTP secara otomatis, sehingga Anda dapat fokus pada parameter model daripada detail jaringan.

Konfigurasi URL Dasar & Kunci

Autentikasi ditangani melalui token Bearer di header Authorization. Anda mendapatkan kunci Anda dengan mendaftar dengan email dan kata sandi di dasbor kami. Tidak diperlukan kartu kredit untuk uji coba, dan Anda dapat membuat ulang kunci Anda kapan saja untuk mencabut akses.

Atur URL dasar ke endpoint khusus kami. Ini memastikan semua permintaan dikirim ke infrastruktur model tanpa sensor kami, bukan ke cloud OpenAI default. Anda dapat menemukan kunci API Anda di halaman 'Dapatkan kunci API' segera setelah pendaftaran.

Kirim Permintaan Pertama Anda

Kirim permintaan penyelesaian obrolan standar untuk menguji konektivitas. ID model selalu uncensored. Model ini disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, menjadikannya ideal untuk penulisan kreatif, roleplay, atau penelitian tanpa batasan.

• Gunakan POST /v1/chat/completions untuk pembuatan teks.
• Jendela konteks mendukung hingga 100.000 token untuk prompt plus penyelesaian.
• Permintaan dibebankan berdasarkan jumlah token input dan output.

Copycurl https://api.hermesllmapi.com/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."}]
  }'

Aktifkan Streaming (SSE)

Untuk pengalaman pengguna yang lebih baik, aktifkan streaming untuk menerima token saat dihasilkan. Ini mengurangi latensi yang dirasakan, terutama untuk respons yang lebih panjang. Server mengembalikan Server-Sent Events (SSE) yang dapat diparsing klien Anda secara real-time.

Atur parameter stream menjadi true di body permintaan Anda. SDK akan menghasilkan chunk saat tiba. Ini sangat berguna untuk antarmuka obrolan di mana Anda ingin menampilkan teks secara bertahap daripada menunggu seluruh respons selesai.

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)

Gunakan Pemanggilan Alat/Fungsi

API kami mendukung pemanggilan fungsi, memungkinkan model menghasilkan JSON terstruktur untuk eksekusi alat eksternal. Tentukan fungsi Anda di parameter tools, dan model akan mengembalikan tool_calls di respons jika sesuai.

Fitur ini bekerja persis seperti yang didokumentasikan dalam spesifikasi OpenAI. Anda dapat mem-parsing nama fungsi dan argumen, menjalankan logika backend Anda, dan memberikan kembali hasilnya ke percakapan. Ini sepenuhnya kompatibel dengan alur kerja pemanggilan alat SDK OpenAI standar.

Copyimport OpenAI from "openai";

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

Periksa Model yang Tersedia

Query endpoint model untuk memverifikasi konektivitas dan melihat opsi yang tersedia. Saat ini, kami menawarkan satu model khusus: uncensored. Kesederhanaan ini menghindari kompleksitas routing model atau infrastruktur generik, memastikan perilaku yang dapat diprediksi.

Anda juga dapat menggunakan endpoint ini untuk debug masalah autentikasi. Jika permintaan gagal, periksa validitas kunci API Anda dan konektivitas jaringan. Respons akan mencantumkan detail model, termasuk ukuran jendela konteks dan batas token.

Copyfrom openai import OpenAI

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

Kelola Batas Laju & Error

API kami memberlakukan batas 300 permintaan per menit per kunci. Jika Anda melebihi ini, Anda akan menerima error 429. Kami juga mendukung batas body permintaan 8 MB untuk prompt kompleks atau jendela konteks besar.

Error umum termasuk 401 (kunci tidak valid) dan 402 (kredit tidak cukup). Saldo prabayar tidak pernah kedaluwarsa, sehingga Anda dapat mengisi saldo sesuai kenyamanan Anda. Bonus kredit diterapkan secara otomatis untuk pembelian yang lebih besar: +5% dari $50 dan +10% dari $100.