เลือกผู้ให้บริการการดำเนินการสำหรับคำขอ API
ใช้วัตถุผู้ให้บริการ ShareAI เพื่อเลือกผู้ให้บริการการดำเนินการโดยอิสระจากผู้สร้างโมเดลในทุกจุดเชื่อมต่อการอนุมานทั้งสี่.
ในหน้านี้
ตั้งค่า model ไปยังตัวระบุที่อิงตามผู้สร้างโดยเฉพาะ เพิ่ม provider เมื่อคุณต้องการจำกัดหรือจัดอันดับโครงสร้างพื้นฐานที่มีสิทธิ์ดำเนินการคำขอ การละเว้นจะใช้นโยบายค่าเริ่มต้นที่เรียงตามราคาจากต่ำไปสูง.
ใช้ผู้ให้บริการหนึ่งราย#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"provider": {
"only": [
"shareai"
],
"allow_fallbacks": false
},
"model": "openai/gpt-5.4",
"messages": [
{
"role": "user",
"content": "Explain model routing in one sentence."
}
]
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'provider': {'only': ['shareai'], 'allow_fallbacks': False}, 'model': 'openai/gpt-5.4', 'messages': [{'role': 'user', 'content': 'Explain model routing in one sentence.'}]}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"provider": {
"only": [
"shareai"
],
"allow_fallbacks": false
},
"model": "openai/gpt-5.4",
"messages": [
{
"role": "user",
"content": "Explain model routing in one sentence."
}
]
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
ใช้แท็กผู้ให้บริการที่แสดงสำหรับโมเดลที่เลือก. only เป็นข้อจำกัดที่เข้มงวด: การอนุญาตการสำรองข้อมูลจะไม่อนุญาตผู้ให้บริการนอกเหนือจากรายการนี้.
ใช้นโยบายเดียวกันในแต่ละจุดเชื่อมต่อการอนุมาน#
| จุดเชื่อมต่อ | ช่องป้อนข้อมูลหลัก | เลือกโมเดลที่รองรับ |
|---|---|---|
/api/v1/chat/completions | messages | การสนทนาแบบสมบูรณ์ |
/api/v1/responses | input | การตอบกลับ |
/api/v1/embeddings | input | การฝังข้อมูล |
/api/v1/images/generations | prompt | การสร้างภาพ |
นโยบายผู้ให้บริการมีความหมายเหมือนกันในจุดเชื่อมต่อเหล่านี้ ความสามารถของโมเดลและผู้ให้บริการแตกต่างกัน: โมเดลการสนทนาไม่ได้เป็นโมเดลการฝังหรือโมเดลภาพโดยอัตโนมัติ คัดลอกตัวระบุที่มีสิทธิ์สำหรับการดำเนินการจากแคตตาล็อก; จุดเชื่อมต่อแบบเนทีฟต้องการการกำหนดค่าการรองรับ.
เลือกผู้ให้บริการที่มีชื่อ#
JSON
{
"provider": {
"order": [
"PROVIDER_A",
"PROVIDER_B"
],
"allow_fallbacks": false,
"sort": {
"by": "price",
"direction": "asc"
}
}
}
แทนที่ PROVIDER_A และ PROVIDER_B ด้วยแท็กผู้ให้บริการตัวพิมพ์เล็กจริง ด้วยรายการที่เรียงลำดับนี้และการสำรองข้อมูลถูกปิดใช้งาน เฉพาะผู้ให้บริการที่อยู่ในรายการเท่านั้นที่มีสิทธิ์ในลำดับนั้น ผู้ให้บริการที่ระบุเป็นลำดับที่สองยังสามารถถูกเลือกได้หากผู้ให้บริการแรกไม่พร้อมใช้งาน.
รักษาข้อจำกัดของข้อมูลรับรอง#
คำขอของคุณสามารถจำกัดโมเดลและผู้ให้บริการที่อนุญาตของคีย์ API ได้ แต่ไม่สามารถให้สิทธิ์การเข้าถึงนอกเหนือจากสิทธิ์เหล่านั้น การยินยอม OAuth ความเหมาะสมในการเรียกเก็บเงิน และความพร้อมใช้งานของอุปกรณ์ยังคงมีผล.
ถัดไป#
ทุกช่องผู้ให้บริการ · ลำดับการจัดเรียงและพฤติกรรมการสำรองข้อมูล
อัปเดตล่าสุด กันยายน 16, 2026