เอกสาร API และคู่มือเริ่มต้น

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

URL พื้นฐานสำหรับคำขอทั้งหมดคือ https://api.veniceaiapipricing.com/v1. คุณตรวจสอบสิทธิ์โดยการส่งคีย์ API ของคุณใน Authorization header เป็น bearer token การตั้งค่านี้ใช้งานได้กับ SDK ทางการของ OpenAI ใดๆ ก็ได้ เปลี่ยน YOUR_API_KEY ด้วยคีย์ที่สร้างจากแดชบอร์ดบัญชีของคุณ

• จุดปลาย: POST /v1/chat/completions
• ส่วนหัว: Authorization: Bearer YOUR_API_KEY

Copycurl https://api.veniceaiapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return server status code 200"}]
  }'

Endpoint /v1/chat/completions

ส่งประวัติการสนทนาของคุณไปยัง /v1/chat/completions ใช้ uncensored model ID API รับวัตถุข้อความมาตรฐานที่มี role และ content ฟิลด์ข้อมูล ค่าโทเค็นอินพุตอยู่ที่ $0.15 ต่อหนึ่งล้านโทเค็น และค่าโทเค็นเอาต์พุตอยู่ที่ $0.50 ต่อหนึ่งล้านโทเค็น ข้อผิดพลาดและการปฏิเสธไม่ใช้เครดิต

เอนด์พอยต์นี้รองรับการสร้างข้อความเท่านั้น ไม่รองรับรูปภาพ เสียง หรือ embedding คุณสามารถสตรีมการตอบกลับหรือรับข้อความเต็มในรูปแบบวัตถุ JSON เดียวได้

Copyfrom openai import OpenAI

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

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

เปิดใช้งานการสตรีมโดยตั้งค่า stream: true ในบอดีคำขอของคุณ API จะส่งคืนเหตุการณ์ที่ส่งจากเซิร์ฟเวอร์ (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)

Function Calling และโหมด JSON

API รองรับผลลัพธ์ที่มีโครงสร้างและการกำหนดเครื่องมือ (tool definitions) ใช้ response_format: {"type": "json_object"} เพื่อบังคับให้ส่งออกเป็น JSON คุณยังสามารถส่ง tools สำหรับการเรียกใช้ฟังก์ชัน ซึ่งอนุญาตให้โมเดลส่งคืนข้อมูลที่มีโครงสร้างสำหรับตรรกะแอปพลิเคชันของคุณ

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

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

ควบคุมความคิดสร้างสรรค์ด้วย temperature และ top_pThe seed parameter ensures deterministic outputs for testing. These parameters follow standard OpenAI conventions. Adjusting them affects the randomness of the generated text.

ตั้งค่า temperature to 0.7 for balanced creativity. Use seed เพื่อความผลลัพธ์ที่ทำซ้ำได้ API จะละเว้นพารามิเตอร์ที่ไม่รองรับอย่างราบรื่น

อัตราจำกัดและข้อจำกัด

คุณจำกัดการใช้งานที่ 300 คำขอต่อนาทีต่อคีย์ อนุญาตคำขอพร้อมกันได้สูงสุด 8 คำขอต่อคีย์ ขนาด body ของคำขอจำกัดไว้ที่ 8 MB หน้าต่างบริบท (context window) รองรับ 100,000 tokens รวมสำหรับ input และ output คำขอแต่ละครั้งสามารถสร้าง output ได้สูงสุด 16,000 tokens

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

Node.js

Copyimport OpenAI from "openai";

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