Referință pentru politica furnizorilor

Consultă câmpurile, valorile implicite, limitele și erorile furnizorilor ShareAI pentru a alege furnizorii de execuție în cererile de inferență.

Vizualizează ca Markdown

Pe această pagină

Opționalul provider obiect aparține nivelului superior al cererii de inferență, alături de model. Un obiect gol folosește valorile implicite. Este separat de Accesul la Distanță al Furnizorului și de acreditivele sale de gestionare.

Câmp	Tip	Comportament
`only`	array de etichete ale furnizorilor	Restricționează execuția la acești furnizori.
`ignore`	array de etichete ale furnizorilor	Exclude acești furnizori, inclusiv din fallback.
`order`	array de etichete ale furnizorilor	Prioritizează acești furnizori în ordinea furnizată; apoi aplică sortarea.
`allow_fallbacks`	boolean; valoare implicită true	Permite alți furnizori eligibili. Cu false și o listă de ordine nenulă, rămân doar furnizorii listați; fără ordine, rămâne doar furnizorul clasat primul.
`networks`	array	Restricționează tipurile de furnizori la comunitate, companie și/sau shareai.
`sort`	string sau obiect	Folosește preț, latență sau throughput, sau un obiect cu by și direction.

JSON

{
  "provider": {
    "ignore": [
      "PROVIDER_TO_EXCLUDE"
    ],
    "networks": [
      "company",
      "shareai"
    ],
    "sort": {
      "by": "throughput",
      "direction": "desc"
    },
    "allow_fallbacks": true
  }
}

Înlocuiește placeholder-ul cu o etichetă reală de furnizor în litere mici sau elimină câmpul ignore. Tipurile de rețea selectează categorii de infrastructură; nu identifică creatorii de modele.

Sortează valorile implicite#

Sortează	Direcția implicită	Revers explicit
`price`	`asc` — cel mai mic primul	`desc` — cel mai mare primul
`latency`	`asc` — cel mai scurt timp de execuție primul	`desc` — cel mai lung primul
`throughput`	`desc` — cele mai multe tokenuri de ieșire pe secundă primul	`asc` — cele mai puține primul

Pentru un obiect, setează by la unul dintre aceste nume și direction către asc sau desc. Vezi cum funcționează măsurătorile și fallback-ul.

Validare și erori#

Folosește booleeni JSON și array-uri de etichete ale furnizorilor în litere mici. Nu trimite null pentru furnizor sau sortare.
Doar câmpurile listate sunt acceptate; aceasta nu este o implementare completă a parametrilor OpenRouter.
Politica este limitată la 8 KiB. Listele only, ignore și order acceptă fiecare cel mult 100 de etichete.
Politicile invalide returnează HTTP 400. Domeniile de acreditive interzise returnează HTTP 403. Niciun furnizor eligibil disponibil returnează HTTP 503.

O politică minimală#

JSON

{
  "provider": {
    "sort": "price"
  }
}

Când este omisă complet, selecția furnizorului implică de asemenea o clasificare deterministă crescătoare după preț. Constrângerile se aplică întotdeauna înainte de clasificare.

Ultima actualizare septembrie 16, 2026