เริ่มต้นใช้งาน API Dolphin AI

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

เริ่มด้วยการตั้งค่า URL ฐานและคีย์ API ในการกำหนดค่าไคลเอนต์ของคุณ คำขอทั้งหมดจะตรวจสอบสิทธิ์ผ่าน Authorization header โดยใช้คีย์เฉพาะของคุณ บริการของเราทำหน้าที่เป็นผู้ให้บริการอิสระสำหรับ openrouter dolphin AI รุ่นโมเดล ซึ่งหมายความว่าคุณไม่จำเป็นต้องมีบัญชีบน OpenRouter เพื่อใช้จุดปลายนี้ เพียงรับคีย์ของคุณจากแดชบอร์ดแล้วนำไปใส่ในตัวแปรสภาพแวดล้อมของคุณ

• Base URL: https://api.openrouterdolphinai.com/v1
• ส่วนหัว: Authorization: Bearer YOUR_API_KEY

การตั้งค่านี้ใช้งานได้กับ SDK ของ OpenAI มาตรฐานใดๆ เพราะเราเลียนแบบโครงสร้าง endpoint ของพวกเขาอย่างแม่นยำ คุณจะโต้ตอบเฉพาะกับ endpoint chat completions เท่านั้น ทำให้การผสานรวมของคุณเรียบง่ายและมุ่งเน้นไปที่การสร้างข้อความ

คำขอครั้งแรก

ส่งข้อความแรกเพื่อสร้างข้อความโดยใช้ POST method. The model ID is always uncensored, ซึ่งช่วยให้แน่ใจว่าคุณได้รับเวอร์ชัน uncensored เฉพาะที่ปรับแต่งสำหรับการสนทนาแบบไร้ข้อจำกัด คุณไม่จำเป็นต้องระบุพารามิเตอร์การกำหนดเส้นทางที่ซับซ้อนเนื่องจากเราโฮสต์โมเดลนี้โดยตรง

ใช้คำสั่ง curl ด้านล่างเพื่อทดสอบการเชื่อมต่อของคุณทันที:

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

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

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

ผสานได้อย่างรวดเร็วโดยใช้ไลบรารี Python ทางการของ OpenAI โดยชี้ไปยัง base URL ของเรา ซึ่งช่วยให้คุณใช้วิธีการที่คุ้นเคยเช่น chat.completions.create() โดยไม่ต้องเขียนโค้ด logic ใหม่ทั้งระบบ ไลบรารีจัดการการ serialize โดยอัตโนมัติ ทำให้คุณสามารถโฟกัสกับการออกแบบ prompt แทนรายละเอียด HTTP

กำหนดค่าไคลเอนต์ด้วย URL พื้นฐานและคีย์ของคุณ:

Copyfrom openai import OpenAI

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

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

การใช้งาน Node SDK

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

เริ่มต้นใช้งาน client ด้วย endpoint ที่ถูกต้อง:

Copyimport OpenAI from "openai";

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

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

การตอบกลับแบบสตรีมมิ่ง

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

จัดการชิ้นส่วนสตรีมเพื่อสะสมข้อความสุดท้าย:

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)

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

ข้อจำกัด, ข้อผิดพลาด & บริบท

ทำความเข้าใจขอบเขตทางเทคนิคเพื่อหลีกเลี่ยงการหยุดทำงานที่ไม่คาดคิดในแอปพลิเคชันของคุณ API ของเราบังคับใช้หน้าต่างบริบทขนาด 100,000 token สำหรับแต่ละคำขอ ซึ่งรวมทั้ง prompt และ completion หากเกินขีดจำกัด output ขนาด 16,000 token การสร้างข้อความจะหยุดลง ดังนั้นจงตั้งค่า max_tokens ตามลำดับเพื่อควบคุมค่าใช้จ่าย

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