Sanggunian sa patakaran ng provider

Sumangguni sa mga field ng ShareAI provider, mga default, limitasyon, at error para sa pagpili ng execution providers sa mga inference request.

Tingnan bilang Markdown

Sa pahinang ito

Ang opsyonal provider object ay nasa pinakamataas na antas ng inference request, kasabay ng model. Ang isang walang laman na object ay gumagamit ng mga default. Ito ay hiwalay mula sa Provider Remote Access at sa mga management credential nito.

Patlang	Uri	Pag-uugali
`only`	array ng mga provider tag	Limitahan ang pagpapatupad sa mga provider na ito.
`ignore`	array ng mga provider tag	Huwag isama ang mga provider na ito, kabilang ang fallback.
`order`	array ng mga provider tag	I-rank ang mga provider na ito una ayon sa ibinigay na pagkakasunod-sunod; pagkatapos ay mag-apply ng pag-aayos.
`allow_fallbacks`	boolean; default true	Payagan ang iba pang kwalipikadong provider. Kapag false at may nonempty na order list, tanging ang mga nakalistang provider ang mananatili; kung walang order, tanging ang unang na-rank na provider ang mananatili.
`networks`	array	Limitahan ang mga uri ng provider sa community, company at/o shareai.
`sort`	string o object	Gumamit ng price, latency o throughput, o isang object na may by at direction.

JSON

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

Palitan ang placeholder ng isang tunay na lowercase provider tag, o alisin ang ignore field. Ang mga uri ng network ay pumipili ng mga kategorya ng imprastruktura; hindi nila tinutukoy ang mga model creator.

Ayusin ang mga default#

Ayusin	Default na direksyon	Explicit reverse
`price`	`asc` — pinakamababa muna	`desc` — pinakamataas muna
`latency`	`asc` — pinakamaikling oras ng paglipas muna	`desc` — pinakamahaba muna
`throughput`	`desc` — pinakamaraming output tokens kada segundo muna	`asc` — pinakamababa muna

Para sa isang object, itakda by sa isa sa mga pangalang ito at direction sa asc or desc. Tingnan kung paano gumagana ang mga sukat at fallback.

Pag-validate at mga error#

Gumamit ng JSON booleans at mga array ng lowercase provider tags. Huwag magpadala ng null para sa provider o sort.
Tanging ang mga nakalistang field ang tinatanggap; hindi ito isang kumpletong OpenRouter parameter implementation.
Ang polisiya ay limitado sa 8 KiB. Ang only, ignore at order lists ay tumatanggap ng hanggang 100 tags bawat isa.
Ang mga invalid na polisiya ay nagbabalik ng HTTP 400. Ang mga forbidden credential scope ay nagbabalik ng HTTP 403. Ang kawalan ng kwalipikadong available na provider ay nagbabalik ng HTTP 503.

Isang minimal na polisiya#

JSON

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

Kapag hindi isinama nang buo, ang pagpili ng provider ay default din sa deterministic price-ascending ranking. Ang mga constraint ay palaging nalalapat bago ang pag-rank.

Huling na-update noong Setyembre 16, 2026