API สไตล์ OpenAI พร้อม cURL และ Bearer Token
เพื่อเรียก API สไตล์ OpenAI จาก command line คุณส่ง HTTP POST พร้อม header Authorization ที่เก็บ token ของคุณ หน้านี้ให้คำสั่ง cURL ที่ใช้งานได้สำหรับทุกฟีเจอร์ของ API นี้ และการตรวจสอบเมื่อมีข้อผิดพลาด
อัปเดต

ประเด็นสำคัญ
- โทเคนจะอยู่ในส่วนหัว Authorization: Bearer YOUR_KEY และรหัสโมเดลคือ uncensored
- มี 2 endpoints: GET /v1/models และ POST /v1/chat/completions
- เพิ่ม -N และ stream true เพื่อดูโทเคนที่มาผ่าน server-sent events
- อ่าน X-Balance-USD และ rate limit headers ด้วย curl -i; 429 หมายถึงรอและลองใหม่
คำขอแบบขั้นต่ำ
นี่คือวิธีที่สั้นที่สุดในการทำ open ai api curl with token กับบริการนี้ ใส่ key ใน environment variable เพื่อให้ไม่ไปอยู่ใน shell history ของคุณ แล้วส่งข้อความแชท:
export UF_KEY="paste-your-key-here"
curl https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what a bearer token is in two sentences."}
]
}'
response เป็น JSON ในรูปแบบ chat completion ของ OpenAI คำตอบอยู่ที่ choices[0].message.content และ object usage รายงานโทเคน prompt และ completion แต่ละส่วนของคำสั่งมีหน้าที่:
Authorization: Bearer ...มีโทเคน "Bearer" เป็นชื่อ scheme ใครที่มีโทเคนจะถูกมองว่าเป็นเจ้าของ ซึ่งเป็นเหตุผลที่คุณเก็บมันออกจาก repository สาธารณะContent-Type: application/jsonบอกเซิร์ฟเวอร์ว่าจะอ่าน body อย่างไร หากไม่มีคำขออาจล้มเหลวพร้อมข้อผิดพลาดการแยกวิเคราะห์ bodymodelต้องเป็นuncensoredโมเดลเดียวที่ API นี้ให้บริการmessagesคือรายการของออบเจ็กต์ที่มีrole(system, user, assistant หรือ tool) และcontent
เพื่อรับคีย์ ให้สมัครด้วย Google หรืออีเมลและรหัสผ่าน แล้วไปที่ หน้า API key ผู้ใช้ใหม่สามารถขอเครดิตทดลองใช้ $0.50 ได้ด้วยคลิกเดียวที่นั่น: ไม่ต้องใช้บัตร ใช้ได้ 7 วัน ต่อหนึ่งบุคคล
ตรวจสอบคีย์ด้วย GET /v1/models
ก่อนดีบักคำขอที่ยาว ยืนยันว่าโทเคนใช้งานได้ด้วยการเรียกใช้ที่ราคาถูกที่สุด การแสดงรายการโมเดลไม่มีค่าใช้จ่าย และแสดงว่า URL, header และคีย์ถูกต้องหรือไม่
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY"
คำตอบที่ดีคือรายการ JSON ที่มี uncensored หากติดตั้ง jq ไว้แล้ว ให้ส่งผลลัพธ์ผ่าน pipeline เพื่อดึงเฉพาะ ID:
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'
หากไม่มีผลลัพธ์ที่มีประโยชน์ ให้ดำเนินการตามรายการด้านล่างตามลำดับ เนื่องจากสาเหตุถูกเรียงตามความถี่ของการเกิด:
- ตัวแปรว่างเปล่า ให้รัน
echo "${UF_KEY:0:6}"เพื่อดูอักขระต้นๆ โดยไม่ต้องพิมพ์คีย์ทั้งหมด - header พิมพ์ผิด หรือขาด "Bearer" นำหน้าคีย์
- เครื่องหมายคำพูดโค้งจากเอกสารหรือไคลเอนต์แชทแทนที่เครื่องหมายคำพูดตรงในคำสั่ง
- URL ฐานไม่ถูกต้อง คือ
https://api.unfilteredaimodels.com/v1โดยมีapi.นำหน้า และ/v1ต่อท้าย - คีย์ถูกคัดลอกพร้อมช่องว่างหรือบรรทัดใหม่ต่อท้าย
อ่านส่วนหัวของคำตอบ
เพิ่ม -i เพื่อรวม headers ใน output หรือ -D - เพื่อพิมพ์ headers โดยที่ body สะอาด:
curl -s -D - -o /dev/null \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'
ส่วนหัวของคำตอบสี่รายการที่ควรทราบ:
| เฮดเดอร์ | ความหมาย |
|---|---|
X-Request-Id | ตัวระบุคำขอนี้ หากติดต่อฝ่ายสนับสนุน ให้อ้างอิงค่านี้ |
X-Balance-USD | เครดิตแบบเติมเงินล่วงหน้าที่เหลือของคุณ |
X-RateLimit-Limit-Requests | จำนวนคำขอต่อนาทีที่อนุญาตสำหรับคีย์ของคุณ |
X-RateLimit-Limit-Concurrency | จำนวนคำขอพร้อมกันที่อนุญาตสำหรับคีย์ของคุณ |
ขีดจำกัดคือ 300 คำขอต่อนาทีและ 8 คำขอพร้อมกันสำหรับคีย์เต็ม และ 60 ต่อนาทีและ 2 คำขอพร้อมกันสำหรับคีย์ทดลอง คำขอข้างต้นตั้งค่า max_tokens เป็น 5 เพื่อทดสอบให้เล็กที่สุด ในการใช้งานปกติ max_tokens เป็นตัวเลือกได้ และการสร้างผลลัพธ์สามารถใช้โทเคนที่เหลือจากหน้าต่าง 100,000 โทเคนหลังจากพรอมต์ของคุณ
สตรีมมิงจากคำสั่ง
ตั้งค่า "stream": true และเพิ่ม -N เพื่อให้ curl ไม่เก็บบัฟเฟอร์ผลลัพธ์ คุณจะเห็นบรรทัดที่ขึ้นต้นด้วย data: ซึ่งแต่ละบรรทัดมีข้อมูลเดลตา JSON เล็กๆ และบรรทัดสุดท้าย data: [DONE] ส่วนชิ้นส่วนก่อนหน้ามีข้อมูลการใช้โทเคน
curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
}'
เพื่อพิมพ์เฉพาะข้อความ ให้กรองสตรีมด้วย pipeline สั้นๆ:
curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
| sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
| jq -rj '.choices[0].delta.content // empty'
echo
คำขอแบบสตรีมมิงจะสงวนช่องการทำงานพร้อมกันไว้จนกว่าการสตรีมจะสิ้นสุด หากคุณเริ่มสตรีมหลายรายการพร้อมกันจากสคริปต์แล้วลืมให้เสร็จสิ้น คุณจะชนกับขีดจำกัดการทำงานพร้อมกันแม้ว่าอัตราคำขอจะต่ำก็ตาม
โหมด JSON และการเรียกใช้เครื่องมือ
โหมด JSON ทำให้โมเดลส่งคืนวัตถุ JSON ที่ถูกต้องเพียงวัตถุเดียว ระบุรูปร่างที่คุณต้องการในพรอมต์ด้วย มิฉะนั้น คีย์จะเป็นค่าใดก็ได้ที่โมเดลเลือก
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
]
}' | jq -r '.choices[0].message.content'
การเรียกใช้ฟังก์ชันใช้ฟิลด์มาตรฐาน tools และ tool_choice โมเดลตอบกลับด้วยอาร์เรย์ tool_calls แทนข้อความ คุณเรียกใช้ฟังก์ชันเองและส่งผลลัพธ์กลับเป็นข้อความด้วย role: "tool" และ tool_call_id ที่ตรงกัน
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"tool_choice": "auto",
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
}'
ในคำตอบ ให้ดู choices[0].message.tool_calls[0].function.arguments ซึ่งเป็น string JSON ที่คุณต้อง parse เรียกใช้ฟังก์ชันสภาพอากาศของคุณเอง แล้วส่งกลับในคำขอถัดไป พารามิเตอร์เช่น temperature, top_p, stop, seed และ penalties จะถูกส่งผ่าน เอกสารประกอบ ระบุฟิลด์ที่รองรับทั้งหมด
รักษาโทเคนให้ปลอดภัยและคำสั่งให้เรียบร้อย
Bearer token คือรหัสผ่านที่มีชื่ออื่น ใครก็ตามที่มีมันสามารถใช้จ่ายเครดิตของคุณได้ ดังนั้นจึงควรดูแลอย่างระมัดระวัง อย่าวางคีย์จริงลงใน issue สาธารณะ ภาพหน้าจอ หรือ log terminal ที่แชร์ หากสงสัยว่าคีย์รั่ว ให้เปลี่ยนจากหน้าคีย์และอัปเดตสคริปต์ของคุณ
Shell history คือการรั่วไหลที่พบบ่อยที่สุดบนเครื่องส่วนตัว การพิมพ์คีย์โดยตรงลงในคำสั่งจะเก็บไว้ในไฟล์ history การตั้งค่าครั้งเดียวด้วย export ยังเก็บบรรทัดนั้นอยู่ นิสัยที่สะอาดกว่าสองอย่างช่วยได้ อ่านคีย์จากไฟล์ที่คุณเพียงคนเดียวที่เปิดได้ หรือเพิ่ม space นำหน้าคำสั่งหาก shell ของคุณตั้งค่าให้ละเว้นบรรทัดที่ขึ้นต้นด้วย space ไฟล์ขนาดเล็กทำงานได้ดี:
mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key
export UF_KEY="$(cat ~/.config/uf/key)"
การอ่านบอดี้ JSON ยาวๆ ภายในเครื่องหมายคำพูดเดี่ยวทำได้ยาก และการใส่เครื่องหมายคำพูดจะผิดพลาดทันทีเมื่อพรอมต์มีเครื่องหมายอโพสโทรฟอยู่ ให้เก็บบอดี้ไว้ในไฟล์แล้วให้ curl อ่านด้วย -d @file:
cat > request.json <<'JSON'
{
"model": "uncensored",
"temperature": 0.3,
"messages": [
{"role": "system", "content": "You answer in plain language."},
{"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
]
}
JSON
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d @request.json | jq -r '.choices[0].message.content'
แนวทางเดียวกันนี้ทำให้จัดการพรอมต์ขนาดใหญ่ภายใต้ขีดจำกัด body 8 MB ได้ง่าย และไฟล์สามารถทำ versioning ใน git ได้ในขณะที่คีย์อยู่นอก repository บน Windows PowerShell เครื่องหมายคำพูดเดี่ยวรอบ JSON ทำงานแตกต่างกันและการต่อบรรทัดด้วย backslash ไม่มีอยู่ รูปแบบ -d @request.json หลีกเลี่ยงปัญหาทั้งสองอย่าง และคุณสามารถใช้ backtick ที่ท้ายบรรทัดเพื่อต่อคำสั่งได้
เมื่อทดสอบเสร็จ ให้เปลี่ยนไปใช้ SDK ไลบรารี Python และ Node ของ OpenAI รองรับ base URL และคีย์เดียวกัน จัดการ retries และ streaming ให้คุณ และอ่าน response format เดียวกับที่คุณ parse ด้วยมือที่นี่ คำสั่ง cURL ยังคงเร็วที่สุดในการตรวจสอบว่าความล้มเหลวเกิดจากโค้ดของคุณหรือจาก request เอง ดังนั้นควรรักษาคำสั่งที่รู้แล้วว่าใช้งานได้ไว้ในบันทึกของคุณ เมื่อรายงานปัญหาไปยัง support ให้รวม X-Request-Id ของ call ที่ล้มเหลวและ status code ที่แน่นอน; คู่นี้ช่วยให้ผู้สนับสนุนหา request ได้โดยไม่ต้องให้คุณทำซ้ำ และประหยัดการส่ง-รับข้อมูล
ข้อผิดพลาด การลองใหม่ และต้นทุนต่อคำขอ
เมื่อคุณเกินขีดจำกัด API จะตอบกลับ HTTP 429 รหัสข้อผิดพลาดบอกคุณว่าขีดจำกัดใด: rate_limited หมายถึงคำขอมากเกินไปต่อนาที, concurrency หมายถึงมากเกินไปพร้อมกัน การโอเวอร์โหลดชั่วคราวยังส่งกลับ 429 และเพิ่ม Retry-After: 5 Curl สามารถ retry เองสำหรับข้อผิดพลาดชั่วคราว:
curl --retry 3 --retry-delay 5 --retry-all-errors \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
นอกจากนี้ให้เก็บ body ไว้ใต้ 8 MB ซึ่งสำคัญหากคุณโพสต์ไฟล์ที่เข้ารหัสลงในพรอมต์
คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน คำขอที่สำเร็จตามสูตรง่ายๆ: $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens การเรียกทดสอบด้วย 40 input tokens และ 120 output tokens มีค่าใช้จ่าย 40 / 1,000,000 x $0.15 = $0.000006 บวก 120 / 1,000,000 x $0.50 = $0.00006 ดังนั้น $0.000066 ในรวม พันครั้งของพวกเขามาถึง $0.066
เครดิตเป็นแบบเติมเงินล่วงหน้าและไม่หมดอายุ การเติมเงินเริ่มต้นตั้งแต่ $20 ถึง $500 ในจำนวนเต็ม พร้อมโบนัส 5% จาก $50, 10% จาก $100 และ 15% จาก $200 ด้วยคริปโต (USDT บน TRC20, USDC บน Base) หน้า ราคา แสดงรายละเอียด หาก response ดูผิด หน้า ตำนานและข้อเท็จจริง อธิบายว่าโมเดลทำอะไรและไม่ทำอะไร
คู่มือเพิ่มเติม
ถาม-ตอบ
คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว
สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด
โทเคนอยู่ที่ไหนในคำสั่ง cURL?
- ไม่ มันคือบริการที่เข้ากันได้กับ OpenAI แบบอิสระที่รันโมเดลแบบเปิดน้ำหนักเพียงโมเดลเดียว ดังนั้น SDK และคำสั่ง cURL ที่สร้างสำหรับรูปแบบ OpenAI จึงใช้งานได้หลังจากเปลี่ยน base URL และคีย์
ใช้ชื่อโมเดลอะไร?
- ใช้ uncensored คุณสามารถยืนยันได้ด้วยการ GET /v1/models.
ทำไมฉันถึงได้ 429?
- คุณเกินขีดจำกัด รหัส rate_limited หมายถึงคำขอมากเกินไปต่อนาที concurrency หมายถึงคำขอมากเกินไปพร้อมกัน รอไม่กี่วินาที หรือลดจำนวนคำขอพร้อมกัน
ฉันจะดูเครดิตคงเหลือของฉันได้อย่างไร?
- ทุก response มี header X-Balance-USD พิมพ์ headers ด้วย curl -i หรือ curl -D -
นี่คือ API ของ OpenAI อย่างเป็นทางการหรือไม่
- ไม่ มันคือบริการที่เข้ากันได้กับ OpenAI แบบอิสระที่รันโมเดล open-weight model หนึ่งตัว ดังนั้น SDK และคำสั่ง cURL ที่สร้างสำหรับรูปแบบ OpenAI จึงใช้งานได้หลังจากเปลี่ยน base URL และคีย์