TH ▾
Base URL https://api.uncensoredaiapis.com/v1โมเดล uncensored
รับคีย์ API
Uncensored AIคู่มือการย้าย

วิธีใช้ API ที่เข้ากันได้กับ OpenAI ใน 5 ขั้นตอน

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

อัปเดต

ห้าก้าวที่สว่างไสวนำไปสู่กล่องเซิร์ฟเวอร์ แสดงขั้นตอนเริ่มต้นด้วย API สไตล์ OpenAI

ประเด็นสำคัญ

  • 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 ฐาน นั่นคือการตั้งค่าทั้งหมด