Referencia de políticas de proveedores

Consulta los campos, valores predeterminados, límites y errores del proveedor de ShareAI para elegir proveedores de ejecución en solicitudes de inferencia.

Ver como Markdown

En esta página

El opcional provider El objeto pertenece al nivel superior de la solicitud de inferencia, junto con model. Un objeto vacío utiliza los valores predeterminados. Es independiente del Acceso Remoto del Proveedor y sus credenciales de gestión.

Campo	Tipo	Comportamiento
`only`	matriz de etiquetas de proveedores	Restringir la ejecución a estos proveedores.
`ignore`	matriz de etiquetas de proveedores	Excluir estos proveedores, incluidos los de respaldo.
`order`	matriz de etiquetas de proveedores	Priorizar estos proveedores en el orden suministrado; luego aplicar la clasificación.
`allow_fallbacks`	booleano; predeterminado true	Permitir otros proveedores elegibles. Con false y una lista de orden no vacía, solo permanecen los proveedores listados; sin orden, solo permanece el proveedor de mayor rango.
`networks`	matriz	Restringir tipos de proveedores a comunidad, empresa y/o shareai.
`sort`	cadena o objeto	Usar precio, latencia o rendimiento, o un objeto con by y direction.

JSON

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

Sustituye el marcador de posición con una etiqueta de proveedor en minúsculas real, o elimina el campo ignore. Los tipos de red seleccionan categorías de infraestructura; no identifican a los creadores del modelo.

Ordenar valores predeterminados#

Ordenar	Dirección predeterminada	Reverso explícito
`price`	`asc` — menor primero	`desc` — mayor primero
`latency`	`asc` — menor tiempo transcurrido primero	`desc` — mayor primero
`throughput`	`desc` — más tokens de salida por segundo primero	`asc` — menos primero

Para un objeto, establece by en uno de estos nombres y direction to asc or desc. Ver cómo funcionan las mediciones y el respaldo.

Validación y errores#

Usa booleanos JSON y matrices de etiquetas de proveedores en minúsculas. No envíes null para proveedor o clasificación.
Solo se aceptan los campos listados; esto no es una implementación completa de parámetros de OpenRouter.
La política está limitada a 8 KiB. Las listas only, ignore y order aceptan como máximo 100 etiquetas cada una.
Las políticas no válidas devuelven HTTP 400. Los alcances de credenciales prohibidos devuelven HTTP 403. La ausencia de un proveedor elegible disponible devuelve HTTP 503.

Una política mínima#

JSON

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

Cuando se omite por completo, la selección de proveedores también predetermina a una clasificación determinista ascendente por precio. Las restricciones siempre se aplican antes de la clasificación.

Última actualización 16 de septiembre de 2026