Dolphin ai chat คู่มือเริ่มต้นใช้งาน API

SDK Installation & Configuration

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

ใช้วิธีการตัวแปรสภาพแวดล้อมเพื่อรักษาความปลอดภัยของข้อมูลรับรอง base URL คือ HTTPS://api.dolphinaichat.com/v1 วิธีนี้ใช้งานได้กับไคลเอนต์ที่เข้ากันได้กับ OpenAI ใดๆ โดยเปลี่ยน base_url และ API key

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

การส่ง POST request ครั้งแรกของคุณ

ส่งคำขอ chat completion อย่างง่ายเพื่อทดสอบการเชื่อมต่อ ใช้ model ID "uncensored" สำหรับโมเดล open-weight ที่ปรับแต่งสำหรับผลลัพธ์ที่ไม่มีการจำกัด

Copycurl https://api.dolphinaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit the daily server load statistics for the last week"}]
  }'

การจัดการการตอบกลับแบบสตรีม (SSE)

เปิดใช้งานการสตรีมเพื่อรับโทเค็นแบบเรียลไทม์ 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)

Understanding Context Windows & Tokens

โมเดลรองรับหน้าต่างบริบทขนาด 100,000 token สำหรับ prompt และ completion รวมกัน Output สูงสุดคือ 16,000 token ต่อคำขอ ค่า max_tokens ค่าเริ่มต้นคือ 2,048 หากไม่ได้ตั้งค่า ราคา $0.15 ต่อ 1M input token และ $0.50 ต่อ 1M output token

รหัสข้อผิดพลาด & การจำกัดอัตรา

จัดการข้อผิดพลาด HTTP มาตรฐานอย่างเหมาะสม 401 บ่งชี้ว่าคีย์ไม่ถูกต้อง 402 หมายถึงคุณไม่มีเครดิต 429 แจ้งถึงขีดจำกัดอัตรา ขีดจำกัดคือ 300 คำขอต่อนาทีต่อคีย์และ 8 คำขอพร้อมกัน ขนาดสูงสุดของร่างกายคำขอคือ 8 MB

การตั้งค่าโหมด JSON & การเรียกใช้ฟังก์ชัน

ใช้ response_format: {"type": "json_object"} สำหรับผลลัพธ์แบบมีโครงสร้าง เปิดใช้งานการเรียกฟังก์ชันด้วย tools และ tool_choice. รองรับพารามิเตอร์เช่น temperature และ top_p อย่างเต็มที่