Referensi kebijakan penyedia

Referensi bidang penyedia ShareAI, default, batasan, dan kesalahan untuk memilih penyedia eksekusi dalam permintaan inferensi.

Lihat sebagai Markdown

Di halaman ini

Opsional provider objek berada di tingkat atas permintaan inferensi, bersama dengan model. Objek kosong menggunakan default. Ini terpisah dari Akses Jarak Jauh Penyedia dan kredensial pengelolaannya.

Bidang	Tipe	Perilaku
`only`	array tag penyedia	Batasi eksekusi ke penyedia ini.
`ignore`	array tag penyedia	Kecualikan penyedia ini, termasuk dari fallback.
`order`	array tag penyedia	Urutkan penyedia ini terlebih dahulu dalam urutan yang diberikan; kemudian terapkan pengurutan.
`allow_fallbacks`	boolean; default true	Izinkan penyedia lain yang memenuhi syarat. Dengan false dan daftar urutan yang tidak kosong, hanya penyedia yang terdaftar yang tetap; tanpa urutan, hanya penyedia dengan peringkat pertama yang tetap.
`networks`	array	Batasi jenis penyedia ke komunitas, perusahaan, dan/atau shareai.
`sort`	string atau objek	Gunakan harga, latensi, atau throughput, atau objek dengan by dan direction.

JSON

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

Ganti placeholder dengan tag penyedia huruf kecil yang nyata, atau hapus bidang ignore. Jenis jaringan memilih kategori infrastruktur; mereka tidak mengidentifikasi pembuat model.

Urutkan default#

Urutkan	Arah default	Pembalikan eksplisit
`price`	`asc` — terendah terlebih dahulu	`desc` — tertinggi terlebih dahulu
`latency`	`asc` — waktu yang paling singkat terlebih dahulu	`desc` — terlama terlebih dahulu
`throughput`	`desc` — token keluaran terbanyak per detik terlebih dahulu	`asc` — paling sedikit terlebih dahulu

Untuk sebuah objek, atur by ke salah satu nama ini dan direction ke asc atau desc. Lihat bagaimana pengukuran dan fallback bekerja.

Validasi dan kesalahan#

Gunakan boolean JSON dan array tag penyedia huruf kecil. Jangan kirim null untuk penyedia atau pengurutan.
Hanya bidang yang terdaftar yang diterima; ini bukan implementasi parameter OpenRouter yang lengkap.
Kebijakan dibatasi hingga 8 KiB. Daftar only, ignore, dan order masing-masing menerima maksimal 100 tag.
Kebijakan tidak valid mengembalikan HTTP 400. Ruang lingkup kredensial yang dilarang mengembalikan HTTP 403. Tidak ada penyedia yang memenuhi syarat dan tersedia mengembalikan HTTP 503.

Kebijakan minimal#

JSON

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

Ketika dihilangkan sepenuhnya, pemilihan penyedia juga default ke peringkat deterministik berdasarkan harga yang meningkat. Kendala selalu berlaku sebelum peringkat.

Terakhir diperbarui 16 September 2026