ShareAI Platform Docs

Elegir proveedores de ejecución para una solicitud de API

Usa el objeto de proveedor de ShareAI para seleccionar proveedores de ejecución independientemente del creador de un modelo en los cuatro puntos finales de inferencia.

Ver como Markdown
En esta página

Establece model al identificador exacto basado en el creador. Agregar provider cuando desees restringir o clasificar la infraestructura elegible para ejecutar la solicitud. Omitirlo utiliza la política predeterminada de precios ascendentes.

Usar un proveedor#

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."
    }
  ]
}'

Usa las etiquetas de proveedor mostradas para el modelo seleccionado. only es una restricción estricta: permitir alternativas nunca autoriza un proveedor fuera de esta lista.

Usar la misma política en cada punto final de inferencia#

Punto finalCampo principal de entradaElige un modelo que soporte
/api/v1/chat/completionsmessagesFinalización de chat
/api/v1/responsesinputRespuestas
/api/v1/embeddingsinputIncrustaciones
/api/v1/images/generationspromptGeneración de imágenes

La política de proveedor tiene el mismo significado en estos puntos finales. Las capacidades del modelo y del proveedor difieren: un modelo de chat no es automáticamente un modelo de incrustación o de imágenes. Copia un identificador elegible para la operación desde el catálogo; los puntos finales nativos requieren soporte configurado.

Preferir proveedores nombrados#

JSON

{
  "provider": {
    "order": [
      "PROVIDER_A",
      "PROVIDER_B"
    ],
    "allow_fallbacks": false,
    "sort": {
      "by": "price",
      "direction": "asc"
    }
  }
}

Reemplazar PROVIDER_A and PROVIDER_B con etiquetas de proveedor reales en minúsculas. Con esta lista ordenada y las alternativas deshabilitadas, solo los proveedores listados son elegibles, en ese orden. El segundo proveedor listado aún puede ser seleccionado si el primero no está disponible.

Mantener restricciones de credenciales#

Tu solicitud puede limitar los modelos y proveedores permitidos por una clave de API. No puede otorgar acceso fuera de esos permisos. Continúan aplicándose el consentimiento OAuth, la elegibilidad de facturación y la disponibilidad del dispositivo.

Siguiente#

Cada campo de proveedor · Orden de clasificación y comportamiento de alternativas

Última actualización 16 de septiembre de 2026

Documentación de la plataforma ShareAI
Toda la documentación

Buscar por título o contenido.

Preguntar sobre esta página

Elige un asistente para explorar esta página. También puedes copiar la página y pegarla en tu conversación.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI