วิธีใช้ API ที่เข้ากันได้กับ OpenAI ใน 5 ขั้นตอน
การใช้ API สไตล์ OpenAI ทำได้ห้าขั้นตอน: รับคีย์, ติดตั้ง SDK, ชี้ไปที่ Base URL ที่ถูกต้อง, ระบุโมเดล และส่งข้อความ นี่คือแต่ละขั้นตอนพร้อมโค้ดที่คุณสามารถวางได้

ประเด็นสำคัญ
- SDK OpenAI ใดๆ ใช้งานได้ที่นี่เมื่อคุณเปลี่ยน Base URL เป็น https://api.uncensoredaiapis.com/v1 และใช้คีย์ของคุณเอง
- model ID คือ uncensored; เส้นทางหลักคือ POST /v1/chat/completions และ GET /v1/models
- การสตรีมมิง, โหมด JSON และการเรียกใช้ tools ใช้พารามิเตอร์เดียวกันกับ API ทางการ
- ราคา $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens และคุณสามารถเริ่มต้นด้วยเครดิตทดลองใช้ $0.50
สรุปสั้นๆ
หากคุณต้องการทราบว่าใช้การเรียก API ของ openai กับบริการที่ไม่ใช่ OpenAI ได้อย่างไร คำตอบคือรูปแบบคำขอเป็นข้อตกลงร่วม เครื่องไคลเอนต์ที่รองรับข้อตกลงนี้ต้องการค่าสามค่า: ที่อยู่ฐาน (base URL) สำหรับส่งคำขอ, คีย์ (key) สำหรับระบุตัวตน และโมเดล (model) สำหรับรัน เปลี่ยนค่าทั้งสามนี้แล้วโค้ดเดิมก็ใช้งานได้ เว็บไซต์นี้ยึดตามข้อตกลงดังกล่าว ทำให้แพ็กเกจ Python และ Node.js มาตรฐานของ OpenAI รวมถึง curl ธรรมดา ทำงานกับบริการนี้ได้
เข้าใจให้ชัดเจนว่าสิ่งนี้หมายถึงและไม่หมายถึงอะไร ความเข้ากันได้หมายถึงอินเทอร์เฟซตรงกัน ไม่ได้หมายความว่านี่คือบริการ OpenAI ทางการหรือรันโมเดลของ OpenAI เบื้องหลังเป็นโมเดล open-weight model เดียวที่ให้บริการโดยผู้ให้บริการอิสระและปรับให้ตอบโดยไม่ปฏิเสธเนื้อหาสำหรับการใช้งานผู้ใหญ่ที่ถูกต้องตามกฎหมาย และคุณเลือกมันด้วย model ID uncensored รองรับเฉพาะข้อความ: ไม่มีรูปภาพ เสียง embedding หรือ fine-tuning
ขั้นตอนด้านล่างใช้เวลาประมาณสิบนาที หากคุณต้องการอ่านตัวอย่างโค้ดที่เสร็จแล้วในหลายภาษา ดูที่ หน้าตัวอย่างโค้ด
ขั้นตอนที่ 1: รับคีย์ API
สมัครด้วย Google หรือด้วยอีเมลและรหัสผ่าน และเปิดหน้า API key ผู้ใช้ใหม่สามารถรับเครดิตทดลองใช้ $0.50 ได้ด้วยการคลิกหนึ่งครั้ง ใช้ได้ 7 วัน จำกัดหนึ่งต่อคน และไม่ต้องใช้บัตร คัดลอกคีย์และเก็บเป็น environment variable แทนการวางลงในโค้ด:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"คีย์ทดลองจำกัดที่ 2 คำขอพร้อมกัน และ 60 คำขอ ต่อนาที คีย์ที่เติมเงินแล้วอนุญาตให้ 8 คำขอพร้อมกัน และ 300 ต่อนาที รายละเอียดของสิ่งที่การทดลองใช้รวมอยู่ใน คำถามที่พบบ่อยเกี่ยวกับการทดลองใช้ฟรี
ขั้นตอนที่ 2: ติดตั้ง SDK และส่งคำขอแรก
ติดตั้งแพ็กเกจทางการสำหรับภาษาของคุณ ทั้งสองไลบรารีนี้คือไลบรารีเดียวกันที่คุณจะใช้กับบริการสไตล์ OpenAI ใดๆ:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openaiนี่คือการเรียกครั้งแรกใน Python ความแตกต่างเดียวจากการตั้งค่าเริ่มต้นคืออาร์กิวเมนต์ base_url:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)และคำสั่งเดียวกันใน Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);ขั้นตอนที่ 3: เข้าใจอาร์เรย์ข้อความ (messages array)
โมเดลแชตไม่จำอะไรระหว่างการเรียกแต่ละครั้ง แต่ละคำขอจะส่งการสนทนาทั้งหมดเป็นรายการข้อความ และแต่ละข้อความมีบทบาท
systemกำหนดพฤติกรรมและสไตล์ ใส่บุคลิก, กฎรูปแบบและข้อจำกัดที่นี่userเก็บสิ่งที่ผู้ใช้ถามassistantเก็บการตอบกลับก่อนหน้าของโมเดล คุณเพิ่มสิ่งเหล่านี้เองเมื่อต้องการสนทนาต่อtoolเก็บผลลัพธ์ของการเรียกใช้ฟังก์ชัน (function calling) ซึ่งอธิบายด้านล่าง
เพื่อดำเนินการสนทนาต่อ ให้เพิ่มการตอบกลับของผู้ช่วยและข้อความผู้ใช้ถัดไปที่รายการเดียวกันและส่งทั้งหมดอีกครั้ง นี่คือเหตุผลที่การสนทนาที่ยาวนานมีค่าใช้จ่ายมากกว่า: ทุกการเรียกจ่ายสำหรับประวัติเต็มเป็นโทเคนอินพุต หน้าต่างบริบทรองรับ 100,000 โทเคนในรวม ทั้งพรอมต์ และคอมพลีชัน ดังนั้นการตัดการสนทนาเก่าออกจึงเป็นส่วนปกติของการสร้างแอปแชท
ฟิลด์การสุ่มตัวอย่างที่มีประโยชน์จะถูกส่งผ่าน: temperature, top_p, stop, seed และค่าปรับความถี่และการปรากฏตัว max_tokens เป็นตัวเลือก ตั้งค่าเมื่อคุณต้องการจำกัดความยาวการตอบกลับและค่าใช้จ่าย
ขั้นตอนที่ 4: สตรีมมิง (streaming), โหมด JSON (JSON mode) และเครื่องมือ (tools)
สตรีมมิง
เพิ่ม stream: true เพื่อรับโทเคนเป็นเหตุการณ์ที่ส่งจากเซิร์ฟเวอร์ (SSE) ทำให้อินเทอร์เฟซรู้สึกเร็ว เพราะข้อความปรากฏขณะที่โมเดลยังเขียนอยู่ และการใช้งานจะถูกรายงานที่ท้ายสตรีมมิง
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}โหมด JSON
ใช้ response_format: {"type": "json_object"} เมื่อโค้ดของคุณ parse การตอบกลับ อธิบายคีย์ที่ต้องการในพรอมต์ด้วย
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'การเรียกใช้ฟังก์ชัน
ส่งรายการ tools พร้อมสคีมาฟังก์ชัน และตัวเลือก tool_choice เมื่อโมเดลต้องการรันฟังก์ชัน การตอบกลับจะมี tool_calls คุณรันฟังก์ชันในโค้ดของคุณเองและส่งผลลัพธ์กลับเป็นข้อความด้วยบทบาท tool การเรียกใช้ฟังก์ชันก็สตรีมมิงด้วย นี่คือบล็อกการสร้างสำหรับ agents; หน้ากรณีการใช้งาน แสดงให้เห็นว่าสิ่งนี้มีประโยชน์ตรงไหน
ขั้นตอนที่ 5: รู้ขีดจำกัด ค่าใช้จ่าย และข้อผิดพลาด
เมื่อเกินขีดจำกัด API จะส่ง HTTP 429 รหัสข้อผิดพลาดคือ rate_limited สำหรับคำขอเกินต่อนาที และ concurrency สำหรับคำขอเกินพร้อมกัน การโอเวอร์โหลดชั่วคราวยังให้ 429 พร้อม Retry-After: 5 header คำขอแบบสตรีมมิงจะรักษา slot concurrency ไว้จนกว่าสตรีมจะสิ้นสุด ดังนั้นให้ปิดสตรีมที่คุณไม่ได้อ่านอีกต่อไป ขอบเขตของ body คือ 8 MB การตอบกลับทุกฉบับมี X-Request-Id และ X-Balance-USD headers และอันแรกคือสิ่งที่คุณอ้างถึงเพื่อสนับสนุน
ต้นทุนนั้นเรียบง่าย การเรียกแชทที่มี input tokens 3,000 และ output tokens 700 มีค่าใช้จ่าย 3,000 เท่าของ $0.15 ต่อล้าน ซึ่งคือ $0.00045 บวก 700 เท่าของ $0.50 ต่อล้าน ซึ่งคือ $0.00035 ดังนั้น $0.0008 ในรวม การเรียกพันครั้งแบบนั้นมีค่าใช้จ่าย $0.80 คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน และเครดิตไม่หมดอายุ หน้าราคา แสดงรายการการเติมเงินตั้งแต่ $20 ถึง $500 พร้อม +5% จาก $50, +10% จาก $100 และ +15% จาก $200 คุณสามารถจ่ายด้วยด้วย crypto (USDT บน TRC20, USDC บน Base)
ความแตกต่างจาก API ทางการ
ความแตกต่างสามประการที่ควรวางแผนไว้ ประการแรก ชื่อโมเดล: ใช้ uncensored ไม่ใช่ชื่อโมเดล OpenAI ประการที่สอง ขอบเขต: คุณได้เพียง chat completions และรายการโมเดลเท่านั้น ดังนั้นฟีเจอร์เช่น image generation, speech, embeddings และ fine-tuning จึงไม่มีอยู่ที่นี่ ประการที่สาม พฤติกรรม: โมเดลถูกปรับแต่งไม่ให้ปฏิเสธคำขอผู้ใหญ่ที่ถูกต้องตามกฎหมาย ดังนั้นผลลัพธ์อาจแตกต่างจากผู้ช่วยที่ถูกกรองอย่างหนัก กฎข้อเดียวที่ไม่เปลี่ยนแปลงคือ: ไม่มีเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์
นิสัยไม่กี่อย่างช่วยได้ในวันแรก เก็บคีย์ไว้ในตัวแปรสภาพแวดล้อม บันทึก X-Request-Id ของทุกการเรียก และตั้งค่า max_tokens ขณะที่คุณทดลองเพื่อให้การตอบกลับที่หลุดควบคุมไม่สามารถใช้จ่ายมากกว่าที่คุณวางแผนไว้ เมื่อคุณสร้างอินเทอร์เฟซแชท ให้สตรีมมิงการตอบกลับและตัดการสนทนาเก่าออกเมื่อประวัติเติบโต เมื่อคุณสร้างระบบประมวลผลต่อเนื่องที่ parse output ให้ใช้โหมด JSON และยังคงป้องกันการทำ parse เพราะการตอบกลับที่ถูกตัดที่ขีดจำกัดโทเคนไม่ใช่ JSON ที่ถูกต้อง และเมื่อสองส่วนของโปรแกรมของคุณเรียก API พร้อมกัน ให้นับสิ่งเหล่านั้นหักล้างกับ 8 คำขอพร้อมกัน ที่คีย์เต็มรูปแบบอนุญาต
อย่าลืมต้นทุนของการทดสอบ การทดลองหลายสิบครั้งด้วยพรอมต์สั้นๆ มีค่าใช้จ่ายน้อยกว่าหนึ่งเซ็นต์ในรวม ดังนั้นเครดิตทดลองใช้ฟรี $0.50 จึงมีประโยชน์มากขณะที่คุณเรียนรู้รูปแบบคำขอ
หากคุณกำลังย้ายแอปที่มีอยู่ คู่มือการย้าย จะแนะนำการเปลี่ยนแปลงตามลำดับ พรอมต์ที่ส่งที่นี่ไม่ถูกใช้ในการฝึก สำหรับแอปส่วนใหญ่ การย้ายมีเพียงสามค่าจากต้นหน้าเว็บนี้และชื่อโมเดล
คู่มือเพิ่มเติม
ถาม-ตอบ
ฉันต้องใช้ OpenAI SDK ทางการหรือไม่?
คุณสามารถใช้ได้ และนั่นเป็นเส้นทางที่ง่ายที่สุด ลูกค้าที่เข้ากันได้กับ OpenAI หรือ HTTP ธรรมดาทั่วไปก็ใช้งานได้เช่นกัน ตราบใดที่รองรับ URL ฐานที่กำหนดเอง
ฉันควรส่งชื่อโมเดลอะไร?
ส่ง uncensored โดย Base URL คือ https://api.uncensoredaiapis.com/v1
นี่คือ API ของ OpenAI อย่างเป็นทางการหรือไม่?
ไม่ มันใช้รูปแบบคำขอเดียวกัน แต่โมเดลเป็นโมเดลแบบเปิดน้ำหนักที่ดำเนินการโดยผู้ให้บริการอิสระ และบริการนี้แยกจาก OpenAI
หนึ่ง request มีค่าใช้จ่ายเท่าใด?
input tokens มีราคา $0.15 ต่อ 1M และ output tokens มีราคา $0.50 ต่อ 1M request ที่มี 3,000 input tokens และ 700 output tokens มีค่าใช้จ่ายประมาณ $0.0008
ฉันสามารถลองใช้มันก่อนจ่ายเงินได้หรือไม่
ใช่ หลังจากลงทะเบียน คุณสามารถขอรับเครดิตทดลองใช้ $0.50 ได้ด้วยการคลิกหนึ่งครั้ง มันใช้งานได้ 7 วัน และไม่จำเป็นต้องใช้บัตร
คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว
สร้างบัญชี คัดลอกคีย์ และเปลี่ยน URL ฐาน นั่นคือการตั้งค่าทั้งหมด