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

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

API ของเราอยู่ที่ HTTPS://api.dolphinia.cc/v1 และต้องการคีย์ API อย่างง่ายสำหรับการร้องขอทุกครั้ง คุณได้รับคีย์นี้ทันทีหลังจากสมัครสมาชิกด้วย Google หรืออีเมลบนแดชบอร์ด และคีย์นี้จะไม่มีวันหมดอายุ ต่างจากตัวรวมที่ซ่อนต้นทุนไว้เบื้องหลังแผนการสมัครสมาชิก เราคิดเงินเฉพาะโทเคนที่คุณใช้งานจริง เก็บคีย์ของคุณให้ปลอดภัยในตัวแปรสภาพแวดล้อมของคุณ เนื่องจากผู้ที่มีคีย์สามารถใช้จ่ายเครดิตที่เติมล่วงหน้าของคุณได้ บริการกำหนดขีดจำกัดการร้องขอ 300 ครั้งต่อนาทีต่อคีย์อย่างเคร่งครัดเพื่อรักษาความเสถียรสำหรับผู้ใช้ทุกคน

การส่ง Chat Completion Request

ส่งการเรียกใช้ครั้งแรกของคุณโดยใช้จุดจบ chat completions มาตรฐานพร้อม model ID "uncensored" คำขอนี้ส่ง prompt ของคุณไปยังเซิร์ฟเวอร์ของเราและส่งข้อความตอบกลับโดยไม่มีการปฏิเสธทั่วไปที่พบในโมเดลอื่น คุณสามารถส่งข้อมูลได้สูงสุด 8MB ใน body ของคำขอเดียว ซึ่งเพียงพอสำหรับกรณีการใช้งานมาตรฐานส่วนใหญ่ หากคุณเกินอัตราจำกัด เซิร์ฟเวอร์จะส่งข้อผิดพลาด 429 ที่ระบุว่าคุณต้องถอยออกชั่วคราว ตรวจสอบเสมอว่า response ของคุณรวมวัตถุ message ที่ถูกต้องก่อนดำเนินการต่อ

การตอบกลับแบบสตรีมมิ่งและการใช้งานโทเค็น

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

Function Calling และโหมด JSON

通过提供请求中的 tools 数组来利用原生函数调用，允许模型返回结构化数据供您的应用程序使用。您还可以使用 response_format 参数强制执行严格的 JSON 输出，这对于需要精确模式遵循的下游系统集成非常理想。该模型支持 tool_choice 选项，以控制它是必须调用函数还是可以自由生成文本。利用这些功能构建与外部 API 或数据库交互的健壮代理，而无需解析杂乱的文。

พารามิเตอร์: Temperature, Top P และ Seeds

ควบคุมความสร้างสรรค์และความสุ่มของผลลัพธ์โดยใช้พารามิเตอร์ temperature, top_p และ seed เหมือนกับที่คุณใช้กับไคลเอนต์ OpenAI ทั่วไป ค่า temperature ต่ำให้ผลลัพธ์ที่มีความแน่นอนมากกว่า ในขณะที่ค่าที่สูงกว่าส่งเสริมความหลากหลายและความสร้างสรรค์มากขึ้น การตั้งค่า seed รับประกันความสามารถในการทำซ้ำ ซึ่งสำคัญต่อการแก้ไขข้อบกพร่องของพฤติกรรมเฉพาะในเวิร์กโฟลว์ LLM uncensored ของคุณ นอกจากนี้คุณยังสามารถกำหนดลำดับ stop เพื่อหยุดการสร้างเมื่อพบเครื่องหมายเฉพาะ ซึ่งให้คุณควบคุมขอบเขตของผลลัพธ์ได้อย่างแม่นยำ

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

โมเดลของคุณรองรับ context window ขนาดใหญ่ 100,000 tokens ซึ่งครอบคลุมทั้ง prompt และ completion รวมกัน สิ่งนี้ช่วยให้คุณส่งเอกสารขนาดใหญ่หรือประวัติการสนทนาที่กว้างขวางโดยไม่สูญเสียข้อมูลเก่า หากคุณส่งคีย์ที่ไม่ถูกต้อง คุณจะรับ error 401 และ error 402 บ่งชี้ว่าเครดิตแบบเติมเงินของคุณหมดแล้ว limit อัตราการส่งคำขอ 429 จะถูกกระตุ้นหากคุณเกิน 300 requests ต่อนาที หรือพยายามทำ 8 concurrent requests พร้อมกัน จัดการ error เหล่านี้อย่างมีเหตุผลในโค้ดของคุณเพื่อให้การทำงานราบรื่น

cURL

Copycurl https://api.dolphinia.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the three main benefits of using Redis for caching."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

การสตรีม

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)