เอกสารประกอบ Hermes API: เริ่มต้นอย่างรวดเร็ว

การติดตั้งและการตั้งค่า

API hermes ทำงานกับไคลเอนต์ใดๆ ที่รองรับรูปแบบ OpenAI คุณต้องการ URL พื้นฐานและคีย์ API สร้างบัญชีผ่าน Google หรืออีเมลในหน้ารับคีย์ API ระบบจะแสดงคีย์ของคุณทันที ไม่ต้องใช้หมายเลขโทรศัพท์ คุณได้รับเครดิตทดลอง $0.50 เป็นเวลาเจ็ดวัน สามารถเติมเงินภายหลังด้วยคริปโตเท่านั้น

• URL ฐาน: HTTPS://api.apihermes.cc/v1
• Auth header: Authorization: Bearer YOUR_API_KEY
• ID โมเดล: uncensored

ติดตั้ง SDK ที่คุณต้องการและตั้งค่า URL พื้นฐาน เอนด์พอยต์นี้คาดหวังพารามิเตอร์ chat completion มาตรฐาน เก็บคีย์ของคุณให้ปลอดภัย คีย์หนึ่งจะแทนที่คีย์ก่อนหน้าหากคุณสร้างคีย์ใหม่

คำขอการเสร็จสิ้นแชทพื้นฐาน

คำขอพื้นฐานส่งข้อความและรับข้อความตอบสนอง รหัสโมเดลคือแบบไร้การเซ็นเซอร์ มันจัดการเนื้อหาสำหรับผู้ใหญ่ที่ถูกต้องตามกฎหมายโดยไม่มีการปฏิเสธ คุณจ่ายตามโทเคนที่ใช้ ข้อผิดพลาดและการปฏิเสธไม่คิดค่าใช้จ่าย หน้าต่างบริบทรองรับ 100,000 โทเคนรวม

จัดโครงสร้างคำขอของคุณด้วยข้อความระบบและข้อความผู้ใช้ API จะส่งผลการสร้างข้อความ คุณสามารถตั้งค่า max_tokens เพื่อควบคุมความยาวของผลลัพธ์ ข้อจำกัดผลลัพธ์เริ่มต้นคือ 2,048 โทเค็น คุณสามารถเพิ่มเป็น 16,000 โทเค็นต่อคำขอ การสตรีมทำงานผ่าน SSE การเรียกฟังก์ชันพร้อมใช้งาน รองรับโหมด JSON

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"}]
  }'

ร่างกายคำขอถูกจำกัดที่ 8 MB อัตราจำกัดคือ 300 คำขอต่อนาที ความพร้อมใช้งานพร้อมกันคือแปดคำขอในเวลาเดียวกัน ตรรกะการลองใหม่จัดการการโอเวอร์โหลดของเซิร์ฟเวอร์อย่างสุภาพ

การตอบกลับแบบสตรีมมิ่งด้วย SSE

การสตรีมส่งโทเค็นเมื่อสร้างเสร็จ เซิร์ฟเวอร์ส่ง Server-Sent Events แต่ละชิ้นมีข้อความบางส่วน ชิ้นสุดท้ายรวมถึงสถิติการใช้งานโทเค็น วิธีการนี้ลดความล่าช้าที่รับรู้สำหรับการตอบกลับที่ยาวนาน เหมาะสำหรับอินเทอร์เฟซแชท คุณต้องจัดการสตรีมอย่างถูกต้อง การตัดการเชื่อมต่ออาจเกิดขึ้นได้ API ไม่รับประกันลำดับการส่งมอบนอกเหนือจากตัวสตรีมเอง

ตั้งค่าพารามิเตอร์ stream เป็น true แยกวิเคราะห์บรรทัดข้อมูล รวมเนื้อหา ตรวจสอบ finish_reason สำหรับความสมบูรณ์ โมเดล uncensored ทำงานกับไคลเอนต์ที่เข้ากันได้กับ OpenAI ส่วนใดก็ได้ กำหนดค่าไคลเอนต์เพื่อจัดการ SSE ตรวจสอบจำนวนโทเค็น URL พื้นฐานยังคงเหมือนเดิม การตรวจสอบสิทธิ์เหมือนกัน ไม่ต้องตั้งค่าเพิ่มเติม

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)

ข้อผิดพลาดปรากฏในสตรีม จัดการโดยปิดการเชื่อมต่อ เครดิตพรีเพดจะหักเฉพาะสำหรับโทเค็นที่สำเร็จ สิ่งนี้ประหยัดเงินในช่วงการหยุดชะงัก คุณไม่ต้องจ่ายสำหรับเอาต์พุตขยะบางส่วน ระบบมีความโปร่งใส

การใช้ Function Calling และ Tools

Function calling ช่วยให้โมเดลดำเนินการโค้ดหรือเครื่องมือ กำหนดเครื่องมือใน body ของคำขอ โมเดลส่งคืนการเรียกใช้เครื่องมือ คุณดำเนินการเครื่องมือ คุณส่งผลลัพธ์กลับ โมเดลสร้างการตอบสนองสุดท้าย สิ่งนี้เปิดใช้งานเวิร์กโฟลว์ที่ซับซ้อน มันไม่ใช่เพียงแค่อินเทอร์เฟซแชท API รองรับเครื่องมือและ tool_choice ใช้สิ่งนี้สำหรับเอเยนต์หรือการอัตโนมัติ

จัดโครงสร้างอาร์เรย์ tools ให้ถูกต้อง ระบุชื่อ คำอธิบาย และพารามิเตอร์ โมเดลจะเป็นผู้ตัดสินใจเมื่อจะเรียกใช้เครื่องมือ คุณต้องวิเคราะห์อาร์กิวเมนต์ ดำเนินการฟังก์ชัน ส่งผลลัพธ์กลับเข้าสู่บทสนทนา โมเดลจะดำเนินการต่อ วงจรนี้จะเกิดขึ้นซ้ำจนกว่าจะได้คำตอบสุดท้าย หน้าต่างบริบทจะติดตามการโต้ตอบทั้งหมดกับเครื่องมือ โปรดติดตามการใช้โทเค็น ค่าใช้จ่ายจะเพิ่มขึ้นเมื่อมีผลลัพธ์จากเครื่องมือ ตรวจสอบการใช้งานในชิ้นข้อมูลสุดท้าย

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)

โมเดลแบบไม่เซ็นเซอร์รองรับสคีมาเครื่องมือที่หลากหลาย ไม่ปฏิเสธเนื้อหา ใช้สิ่งนี้สำหรับการสวมบทบาทหรืองานทางเทคนิค API มีความน่าเชื่อถือ ไม่มีข้อผิดพลาด ระบบชำระเงินล่วงหน้าสร้างความยุติธรรม คุณควบคุมการไหลของข้อมูล URL พื้นฐานมีความสม่ำเสมอ การตรวจสอบสิทธิ์เรียบง่าย

โหมด JSON และพารามิเตอร์

โหมด JSON บังคับให้โมเดลแสดงผล JSON ที่ถูกต้อง ตั้งค่า response_format เป็น json_object ซึ่งมีประโยชน์สำหรับข้อมูลที่มีโครงสร้าง โมเดลจะหลีกเลี่ยงการห่อด้วยมาร์กดาวน์ และส่งคืน JSON ดิบ ใช้สิ่งนี้สำหรับการแยกวิเคราะห์ ซึ่งช่วยปรับปรุงความน่าเชื่อถือ หน้าต่างบริบทยังคงมีผลอยู่ คุณจ่ายตามโทเค็น โมเดลแบบไม่มีเซนเซอร์เคารพรูปแบบนี้ มันจะไม่ปฏิเสธโดยอิงตามเนื้อหา

Parameters include temperature, top_p, stop, seed, presence_penalty, and frequency_penalty. Temperature controls randomness. Top_p controls diversity. Stop sequences halt generation. Seed ensures reproducibility. Presence and frequency penalties adjust token usage. Set these to refine the output. The API supports all standard parameters. Use them to tune the response. The base URL remains the same. Auth is identical.

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

จัดการข้อผิดพลาดผ่านรหัสสถานะ HTTP รหัส 401 หมายถึงคีย์ไม่ถูกต้อง รหัส 402 หมายถึงไม่มีเครดิต รหัส 429 หมายถึงเกินอัตราจำกัด ให้จัดการสิ่งเหล่านี้ในโค้ดของคุณ เครดิตแบบเติมเงินจะหักเฉพาะสำหรับโทเค็นที่สำเร็จเท่านั้น ซึ่งสร้างความยุติธรรม คุณจะไม่จ่ายสำหรับผลลัพธ์ที่ไม่สมบูรณ์ ระบบโปร่งใส โมเดล uncensored มีความน่าเชื่อถือ ใช้สำหรับงานที่ถูกต้องตามกฎหมายได้ทั้งหมด

การจัดการข้อผิดพลาดและขีดจำกัดอัตรา

API ส่งรหัสสถานะ HTTP มาตรฐาน รหัส 401 ระบุคีย์ API ไม่ถูกต้อง รหัส 402 ระบุเครดิตพรีเพย์ไม่เพียงพอ รหัส 429 ระบุขีดจำกัดอัตรา ขีดจำกัดคือ 300 คำขอต่อนาที การทำงานพร้อมกันคือแปดคำขอในเวลาเดียวกัน ร่างคำขอจำกัดอยู่ที่ 8 MB จัดการข้อผิดพลาดเหล่านี้อย่างราบรื่น ลองใหม่ด้วยการถอยหลังแบบเอกซ์โพเนนเชียล โมเดล uncensored ไม่ปฏิเสธเนื้อหาที่ถูกต้องตามกฎหมาย ข้อผิดพลาดไม่เสียค่าใช้จ่าย คุณไม่จ่ายสำหรับคำขอที่ล้มเหลว เครดิตพรีเพย์ปลอดภัย ไม่หมดอายุ ใช้หน้าสนับสนุนสำหรับการเรียกเก็บเงินซ้ำ รับเฉพาะคริปโต USDT หรือ USDC มีโบนัสใช้