TH ▾
รับคีย์ API
API แบบไม่เซ็นเซอร์ที่เข้ากันได้กับ OpenAI สำหรับนักพัฒนาอัปเดต

ตัวอย่าง curl API LLM ที่คัดลอกและรันได้

หากคุณต้องการทดสอบ API LLM curl ก่อนเขียนโค้ด คำขอด้านล่างเพียงพอ แต่ละรายการกำหนดเป้าหมายไปยังเอนด์พอยต์ที่เข้ากันได้กับ OpenAI ใช้โมเดล ID uncensored และรันจากเทอร์มินัลธรรมดา

แผงเทอร์มินัลส่งลำแสงไปยังกล่องเซิร์ฟเวอร์ แทนคำขอ curl ไปยัง API LLM

ตั้งค่า 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 ถูกส่งออกแล้ว
400JSON ผิดรูปแบบหรือฟิลด์ไม่ถูกต้องตรวจสอบร่างคำขอด้วย 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)

ถาม-ตอบ

ฉันส่งคำขอ curl ไปยัง URL ไหน?

ใช้ https://api.uncensoredllmapi.com/v1 เป็นฐาน จากนั้นเพิ่ม /chat/completions, /responses, /models หรือ /balance ขึ้นอยู่กับสิ่งที่คุณต้องการ

ฉันทดสอบการเรียกใช้ฟังก์ชันด้วย curl ได้อย่างไร?

เพิ่มอาร์เรย์ของ tools พร้อมนิยามฟังก์ชันลงใน body ของการส่งการตอบกลับแชท หากโมเดลตัดสินใจเรียกใช้มัน การตอบกลับจะประกอบด้วย tool_calls และคุณส่งผลลัพธ์กลับเป็น message พร้อม role tool

ทำไม curl จึงไม่แสดงอะไรจนกว่าการตอบกลับจะเสร็จสิ้น?

คุณน่าจะกำลังสตรีมโดยไม่มีแฟลก -N เพิ่มแฟลก -N เพื่อให้ curl พิมพ์แต่ละชิ้นส่วนเมื่อมาถึง

คำขอที่ล้มเหลวเสียเงินหรือไม่?

ไม่ คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน

คีย์ของคุณอยู่ห่างเพียงกรอกแบบฟอร์มเดียว

สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด