Alege furnizorii de execuție pentru o cerere API
Utilizează obiectul furnizor ShareAI pentru a selecta furnizorii de execuție independent de creatorul unui model pe toate cele patru puncte finale de inferență.
Pe această pagină
Setează model către identificatorul exact bazat pe creator. Adaugă provider atunci când dorești să restricționezi sau să ordonezi infrastructura eligibilă pentru a executa cererea. Omiterea acestuia utilizează politica implicită de ordonare crescătoare a prețurilor.
Folosește un singur furnizor#
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());
Folosește etichetele furnizorului afișate pentru modelul selectat. only este o restricție strictă: permiterea fallback-urilor nu permite niciodată un furnizor din afara acestei liste.
Folosește aceeași politică pe fiecare endpoint de inferență#
| Endpoint | Câmpul principal de intrare | Alege un model care suportă |
|---|---|---|
/api/v1/chat/completions | messages | Completarea chatului |
/api/v1/responses | input | Răspunsuri |
/api/v1/embeddings | input | Încorporări |
/api/v1/images/generations | prompt | Generarea imaginilor |
Politica furnizorului are același sens pe aceste endpoint-uri. Capacitățile modelului și ale furnizorului diferă: un model de chat nu este automat un model de încorporare sau imagine. Copiază un identificator eligibil pentru operațiune din catalog; endpoint-urile native necesită suport configurat.
Preferă furnizorii numiți#
JSON
{
"provider": {
"order": [
"PROVIDER_A",
"PROVIDER_B"
],
"allow_fallbacks": false,
"sort": {
"by": "price",
"direction": "asc"
}
}
}
Înlocuiți PROVIDER_A și PROVIDER_B cu etichete reale de furnizor scrise cu litere mici. Cu această listă ordonată și fallback-urile dezactivate, doar furnizorii listați sunt eligibili, în această ordine. Al doilea furnizor listat poate fi selectat dacă primul nu este disponibil.
Păstrează restricțiile acreditivului#
Cererea ta poate restrânge modelele și furnizorii permiși de o cheie API. Nu poate acorda acces în afara acestor permisiuni. Consimțământul OAuth, eligibilitatea pentru facturare și disponibilitatea dispozitivului continuă să se aplice.
Următorul#
Fiecare câmp al furnizorului · Ordinea de sortare și comportamentul fallback
Ultima actualizare septembrie 16, 2026