API ของ Gemma: ส่งคำขอแรกในห้านาที

Base URL & การตรวจสอบสิทธิ์

เริ่มโดยสร้างบัญชีที่หน้า Get API key คุณต้องการเพียงอีเมลและรหัสผ่าน ไม่ต้องใช้เบอร์โทรหรือบัตรเครดิตเพื่อเปิดใช้เครดิตทดลองใช้ เมื่อลงทะเบียนแล้ว คีย์ API จะแสดงทันที คัดลอกคีย์นี้และเก็บไว้อย่างปลอดภัย ใช้ใน Authorization header เป็น Bearer token สำหรับทุกคำขอ Base URL สำหรับทุก endpoint คือ https://api.gemma4api.com/v1 URL นี้ใช้กับไคลเอนต์ที่เข้ากันได้กับ OpenAI มาตรฐาน ทำให้เปลี่ยนผู้ให้บริการได้โดยเปลี่ยน Base URL และคีย์ API ในค่ากำหนดของคุณ

คำขอแรก

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

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

การผสานรวม Python SDK

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

Copyfrom openai import OpenAI

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

การผสานรวม Node.js SDK

สำหรับสภาพแวดล้อม JavaScript ให้ติดตั้งแพ็กเกจ OpenAI Node.js กำหนดค่าไคลเอนต์ด้วย Base URL https://api.gemma4api.com/v1 และคีย์ API ของคุณ ใช้รหัสโมเดล uncensored ในคำขอ completion ของคุณ การตั้งค่านี้ช่วยให้คุณรักษาโครงสร้างโค้ดที่เข้ากันได้กับ OpenAI มาตรฐานในขณะที่ได้รับประโยชน์จากพฤติกรรมโมเดลเฉพาะที่โฮสต์บนเซิร์ฟเวอร์ของเรา ตรวจสอบให้แน่ใจว่าคุณจัดการการตอบสนองแบบอะซิงโครนัสได้อย่างถูกต้องภายในลูปเหตุการณ์ Node.js ของคุณ

Copyimport OpenAI from "openai";

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

การตอบสนองแบบสตรีมมิง

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

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)

ขีดจำกัด ข้อผิดพลาด และหน้าต่างบริบท

คำขอของคุณรองรับหน้าต่างบริบท 100,000 โทเคนสำหรับพรอมต์และการสร้างรวมกัน ขีดจำกัดอัตราคือ 300 คำขอต่อนาทีต่อคีย์ พร้อมขนาดบอดี้คำขอสูงสุด 8 MB ข้อผิดพลาดทั่วไป ได้แก่ 401 สำหรับคีย์ที่ไม่ถูกต้อง 402 หากเครดิตแบบเติมเงินล่วงหน้าของคุณหมด และ 429 หากคุณเกินขีดจำกัดต่อนาที การสร้างคีย์ API ใหม่จะเพิกถอนคีย์เก่าแต่จะไม่รีเซ็ตตัวนับอัตรา ตรวจสอบให้แน่ใจว่าไคลเอนต์ของคุณจัดการรหัสสถานะ HTTP เหล่านี้ได้อย่างเหมาะสมเพื่อรักษาการทำงานที่ราบรื่น