Pilih penyedia eksekusi untuk permintaan API
Gunakan objek penyedia ShareAI untuk memilih penyedia eksekusi secara independen dari pembuat model di semua empat endpoint inferensi.
Di halaman ini
Atur model ke pengidentifikasi berbasis pembuat yang tepat. Tambahkan provider saat Anda ingin membatasi atau memberi peringkat infrastruktur yang memenuhi syarat untuk menjalankan permintaan. Menghilangkannya akan menggunakan kebijakan default berdasarkan harga terendah.
Gunakan satu penyedia#
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());
Gunakan tag penyedia yang ditampilkan untuk model yang dipilih. only adalah pembatasan keras: mengizinkan fallback tidak pernah memperbolehkan penyedia di luar daftar ini.
Gunakan kebijakan yang sama pada setiap endpoint inferensi#
| Endpoint | Kolom input utama | Pilih model yang mendukung |
|---|---|---|
/api/v1/chat/completions | messages | Penyelesaian obrolan |
/api/v1/responses | input | Respons |
/api/v1/embeddings | input | Embedding |
/api/v1/images/generations | prompt | Generasi gambar |
Kebijakan penyedia memiliki arti yang sama pada endpoint ini. Kemampuan model dan penyedia berbeda: model obrolan tidak secara otomatis menjadi model embedding atau gambar. Salin pengidentifikasi yang memenuhi syarat untuk operasi dari katalog; endpoint asli memerlukan dukungan yang dikonfigurasi.
Utamakan penyedia yang diberi nama#
JSON
{
"provider": {
"order": [
"PROVIDER_A",
"PROVIDER_B"
],
"allow_fallbacks": false,
"sort": {
"by": "price",
"direction": "asc"
}
}
}
Ganti PROVIDER_A dan PROVIDER_B dengan tag penyedia huruf kecil yang nyata. Dengan daftar urutan ini dan fallback dinonaktifkan, hanya penyedia yang terdaftar yang memenuhi syarat, dalam urutan tersebut. Penyedia kedua yang terdaftar masih dapat dipilih jika penyedia pertama tidak tersedia.
Pertahankan pembatasan kredensial#
Permintaan Anda dapat mempersempit model dan penyedia yang diizinkan oleh kunci API. Itu tidak dapat memberikan akses di luar izin tersebut. Persetujuan OAuth, kelayakan penagihan, dan ketersediaan perangkat tetap berlaku.
Berikutnya#
Setiap kolom penyedia · Urutan pengurutan dan perilaku fallback
Terakhir diperbarui 16 September 2026