ตั้งค่า shell ของคุณและตรวจสอบเอนด์พอยต์
รับคีย์จากหน้า API key แล้วส่งออกพร้อมกับ Base URL เพื่อไม่ให้วางข้อมูลลับลงในคำสั่งทุกคำสั่ง
export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"
ทุกคำขอจะส่งคีย์เป็นโทเคนบียาร์ในส่วนหัว Authorization ร่างคำขอเป็น JSON ดังนั้นให้เพิ่ม Content-Type: application/json เมื่อคุณ POST ขนาดร่างคำขอสูงสุดคือ 8 MB ซึ่งสำคัญเฉพาะเมื่อคุณวางเอกสารขนาดใหญ่มากลงในพรอมต์
ตัวอย่างใช้เครื่องหมายคำพูดเดี่ยวของ Unix shell บน Windows PowerShell ให้วาง JSON ในไฟล์และส่งด้วย --data @body.json เพื่อหลีกเลี่ยงปัญหาการใส่เครื่องหมายคำพูด
การตรวจสอบความถูกต้องที่ประหยัดที่สุดคือการ GET ที่แสดงรายการโมเดล มันยืนยันคีย์และ URL และไม่มีค่าใช้จ่าย
curl -s "$BASE/models" \
-H "Authorization: Bearer $API_KEY"
อาร์เรย์ data ในคำตอบควรรวม ID uncensored 401 หมายถึงคีย์หายไปหรือพิมพ์ผิด หาก curl เชื่อมต่อไม่ได้เลย ให้ตรวจสอบโฮสต์ใน $BASE และตรวจสอบให้แน่ใจว่าลงท้ายด้วย /v1 โดยไม่มีพาธเพิ่มเติม
1. ส่ง chat completion
นี่คือ request ที่ไคลเอนต์สไตล์ OpenAI ส่งภายใต้พื้นผิว
curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Give me three names for a fantasy tavern."}
],
"temperature": 0.8,
"max_tokens": 200
}'
การตอบกลับเป็น JSON ข้อความอยู่ที่ choices[0].message.content และจำนวนโทเคนอยู่ที่ usage ส่ง output ผ่าน jq -r '.choices[0].message.content' หากติดตั้ง jq และต้องการเฉพาะข้อความ field max_tokens เป็นตัวเลือก; ไม่ต้องระบุและ completion อาจใช้ ส่วนที่เหลือของหน้าต่าง 100,000-token
endpoint POST /v1/responses ที่ใหม่กว่าก็พร้อมใช้งานเช่นกันหากไคลเอนต์ของคุณใช้รูปแบบนั้น สำหรับรายการพารามิเตอร์ทั้งหมด ดูที่ เอกสารประกอบ
2. สตรีมคำตอบ
เพิ่ม "stream": true และบอก curl ให้ไม่ buffer ด้วย -N โทเคนจะถูกพิมพ์เมื่อสร้างเสร็จ
curl -N "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Count from one to ten in words."}]
}'
แต่ละบรรทัดขึ้นต้นด้วย data: และเก็บ JSON chunk เล็กๆ ที่มี delta เหตุการณ์สุดท้ายมี usage และ stream จบด้วย data: [DONE] หากไม่มี -N curl จะรอ buffer เต็ม และ output จะดูเหมือนมาถึงพร้อมกัน หมายเหตุว่าคำขอแบบ stream ใช้ slot concurrency หนึ่งจนกว่าจะจบ
3. ขอ JSON
สำหรับ output ที่ script จะ parse ให้เปิด JSON mode ด้วย response_format ระบุคำว่า JSON ใน prompt เพื่อให้โมเดลรู้รูปร่างที่คุณคาดหวัง
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [{"role": "user",
"content": "Return JSON with keys name and level for a fantasy character."}]
}' | jq -r '.choices[0].message.content | fromjson'
ตัวกรอง fromjson จะ parse สตริงใน content ทำให้ jq แจ้ง error ทันทีหากโมเดลส่งค่าที่ไม่ใช่ JSON ถูกใช้ทดสอบได้เร็ว ดูเพิ่มเติมที่ หน้าโหมด JSON
4. ลอง tool call
Tool calling ช่วยให้โมเดลขอให้คุณรันฟังก์ชันในโค้ดของคุณ คุณอธิบายฟังก์ชันในอาร์เรย์ tools และหากโมเดลตัดสินใจใช้ การตอบกลับจะมีรายการ tool_calls แทนข้อความ
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"tool_choice": "auto"
}' | jq '.choices[0].message.tool_calls'
คุณจะได้รับชื่อฟังก์ชันและสตริง JSON ของอาร์กิวเมนต์ โค้ดของคุณจะเรียกใช้ฟังก์ชันนั้น จากนั้นส่งคำขอครั้งที่สองที่ส่งข้อความก่อนหน้านี้ซ้ำ เพิ่มข้อความของผู้ช่วยที่มีการเรียกใช้ฟังก์ชัน และเพิ่มข้อความที่มี role: "tool" พร้อมผลลัพธ์ โมเดลจะเขียนคำตอบสุดท้าย
5. ตรวจสอบส่วนหัวและยอดเงิน
เพิ่ม -i เพื่อดูส่วนหัวของรีสปอนส์พร้อมกับเนื้อหา คุณจะพบ X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests และ X-RateLimit-Limit-Concurrency
curl -s -i "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
| grep -i "^x-"
curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"
การเรียกครั้งที่สองจะคืนเครดิตของคุณโดยตรง เครื่องมือสไตล์ OpenAI สามารถใช้ GET /v1/dashboard/billing/credit_grants แทนได้ คำขอขนาดเล็กเช่นด้านบนมีค่าใช้จ่ายเพียงเศษเสี้ยวของเซ็นต์: ด้วย 10 input token และ 5 output token ราคาคือ 10 x 0.15 / 1,000,000 + 5 x 0.50 / 1,000,000 = $0.000004 ดู หน้าราคาเพื่อดูอัตรา
สคริปต์ทดสอบแบบใช้ซ้ำได้
เมื่อคุณไว้วางใจการเรียกแต่ละรายการแล้ว ให้ห่อหุ้มไว้ในสคริปต์สั้นๆ ที่คุณสามารถรันได้หลังการ deploy การหมุนคีย์ หรือการเปลี่ยนแปลงเครือข่ายใดๆ มันจะล้มเหลวเมื่อพบปัญหาแรก ดังนั้นคุณจะเห็นขั้นตอนที่แตกหักอย่างชัดเจน
set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"
echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'
echo "chat:"
curl -sf "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
| jq -r '.choices[0].message.content'
echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"
แฟล็ก -f ทำให้ curl ออกจากโปรแกรมเมื่อเกิดข้อผิดพลาด HTTP และ set -e หยุดสคริปต์ที่จุดนั้น วางไว้ในงาน cron หรือขั้นตอน CI หากคุณรันบริการบน API นี้และต้องการการแจ้งเตือนล่วงหน้าเมื่อมีบางอย่างเปลี่ยนแปลง เก็บคีย์ไว้ในที่เก็บข้อมูลลับหรือตัวแปรสภาพแวดล้อม อย่าเก็บไว้ในไฟล์สคริปต์
เมื่อคุณเปลี่ยนแปลงคำขอ ให้ลองตั้งค่าหนึ่งอย่างในเวลาเดียวกัน: temperature สำหรับความสุ่ม top_p สำหรับ nucleus sampling stop สำหรับลำดับสิ้นสุดที่กำหนดเอง และ seed สำหรับผลลัพธ์ที่ทำซ้ำได้ ทั้งหมดนี้ถูกส่งผ่านไปยังโมเดล ดังนั้นคุณสามารถเปรียบเทียบผลกระทบจากประวัติเทอร์มินัลเดียวกัน
การอ่านข้อผิดพลาดจาก curl
| รหัส | สาเหตุที่เป็นไปได้ | การแก้ไข |
|---|---|---|
| 401 | คีย์หายไปหรือผิด | ตรวจสอบหัว Authorization และว่า $API_KEY ถูกส่งออกแล้ว |
| 400 | JSON ผิดรูปแบบหรือฟิลด์ไม่ถูกต้อง | ตรวจสอบร่างคำขอด้วย jq . ก่อนส่ง |
429, code rate_limited | มากกว่า 300 คำขอต่อนาที (60 สำหรับคีย์ทดลองใช้) | ลดความเร็วลูปของคุณ |
429, code concurrency | เกิน 8 คำขอพร้อมกัน (2 คำขอสำหรับคีย์ทดลองใช้) | รันงานแบบขนานให้น้อยลง |
429 พร้อม Retry-After: 5 | โอเวอร์โหลดชั่วคราว | รอ 5 วินาทีแล้วลองใหม่ |
เพิ่ม -w "\n%{http_code}\n" เพื่อพิมพ์รหัสสถานะหลังจากเนื้อหา ซึ่งช่วยคุณจากการต้องเดา เนื้อหาของข้อผิดพลาดเป็น JSON พร้อมข้อความและรหัส ดังนั้น jq .error จะแสดงอย่างชัดเจน หากคุณเห็น 429 ในลูป อย่าลองใหม่ทันที; การหยุดพักสักสองสามวินาทีช่วยให้หน้าต่างนาทีและช่อง concurrent ว่างลง และการลองใหม่แบบ tight loop จะทำให้คุณเกินขีดจำกัด คีย์ทดลองมีขีดจำกัดที่เข้มงวดกว่าคีย์เต็ม ดังนั้นสคริปต์ที่ทำงานได้หลังการ top-up ครั้งแรกอาจล้มเหลวเมื่อใช้เครดิตทดลองหากรันงานแบบขนาน เมื่อคำขอทำงานได้ ให้ย้ายไปใช้ SDK; URL และชื่อโมเดลเดียวกันจะถูกส่งต่อโดยไม่เปลี่ยนแปลง บัญชีใหม่สามารถขอเครดิตทดลอง $0.50 ได้ด้วยการคลิกหนึ่งครั้ง เพียงพอสำหรับการทดสอบขนาดเล็กหลายร้อยครั้ง การเติมเงินหลังจากนั้นเริ่มต้นที่ $20 และชำระด้วยคริปโต (USDT บน TRC20 หรือ USDC บน Base)
