APIMaster.ai

Contrôles de routage par requête

Définissez un plafond de prix officiel, un nombre de tentatives et un délai total pour la génération de texte avec des en-têtes HTTP facultatifs.

Contrôles de routage par requête

Inclure ou exclure des canaux

Définissez les canaux pour une requête de génération de texte, d’image ou de vidéo. Vous pouvez combiner les deux en-têtes. Les exclusions sont prioritaires.

  • X-APIMaster-Include-Channels · Autoriser uniquement les canaux de la liste.
  • X-APIMaster-Exclude-Channels · Exclure les canaux de la liste.

Chaque en-tête accepte jusqu’à 64 entiers positifs séparés par des virgules. Consultez les valeurs publiques de channel_id du modèle. La clé API et les préférences de la console déterminent les canaux accessibles. Le canal doit aussi prendre en charge l’opération et les paramètres de la requête.

curl "https://apimaster.ai/api/public/marketplace?model=deepseek-flash"

Les nouvelles tentatives et les solutions de repli respectent ce périmètre. La génération asynchrone le conserve et les endpoints idempotents l’intègrent à leur vérification.

Les en-têtes invalides renvoient 400 invalid_routing_parameter. Sans canal éligible, l’API renvoie 503 no_provider_within_channel_scope. Le suivi et le téléchargement utilisent le canal de la tâche.

Omettez ces en-têtes lors du suivi ou du téléchargement d’un résultat. Les endpoints incompatibles et le pool géré FreeModel renvoient 400 routing_controls_unsupported.

Exemples de génération

curl "https://apimaster.ai/v1/chat/completions" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-APIMaster-Exclude-Channels: $TEXT_CHANNEL_ID" \
  -d '{"model":"deepseek-flash","messages":[{"role":"user","content":"Reply with OK."}]}'

curl "https://apimaster.ai/v1/images/generations/async" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-APIMaster-Include-Channels: $IMAGE_CHANNEL_ID" \
  -d '{"model":"gpt-image-2","prompt":"A blue ceramic cup on a white table","size":"1024x1024"}'

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-APIMaster-Include-Channels: $VIDEO_CHANNEL_ID" \
  -d '{"model":"wan3.0-video-prime","prompt":"A flower sways in a light breeze","duration":2,"resolution":"480P"}'

Prix, tentatives et délais pour le texte

Définissez un plafond de prix officiel, un nombre de tentatives et un délai total pour la génération de texte avec des en-têtes HTTP facultatifs.

En-tête Comportement
X-APIMaster-Max-Official-Price-Ratio Rapport maximal au tarif officiel sous forme de nombre positif. 0.5 autorise la moitié du tarif officiel et 1 le tarif officiel entier.
X-APIMaster-Max-Retries Nombre maximal de tentatives supplémentaires après la première, sous forme d’entier positif ou nul. 0 autorise une seule tentative. Les changements de fournisseur et le recours au fournisseur officiel comptent.
X-APIMaster-Timeout-Ms Délai total en millisecondes, sous forme d’entier positif, à partir de la réception par la passerelle. Il couvre le routage, les tentatives et la diffusion en continu. Le délai le plus court s’applique.

Chaque en-tête est indépendant. Les paramètres omis suivent la politique existante et les préférences de la console restent applicables. Le plafond s’applique aux prix unitaires des entrées, des sorties et du cache applicable. Le coût total dépend de l’usage. Une fois le contenu transmis, le flux ne redémarre pas chez un autre fournisseur.

Points d’accès pris en charge

  • POST /v1/chat/completions
  • POST /v1/responses
  • POST /v1/messages
  • POST /v1beta/models/{model}:generateContent
  • POST /v1beta/models/{model}:streamGenerateContent

Ces contrôles s’appliquent à la génération de texte. Les endpoints d’image, de vidéo et les autres endpoints non pris en charge renvoient 400 routing_controls_unsupported avec ces en-têtes. Les éléments facturés séparément, comme les appels d’outils, sont hors du plafond du texte.

Exemple

curl https://apimaster.ai/v1/chat/completions \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-APIMaster-Max-Official-Price-Ratio: 0.5" \
  -H "X-APIMaster-Max-Retries: 1" \
  -H "X-APIMaster-Timeout-Ms: 30000" \
  -d '{"model":"gpt-6.2-sol","messages":[{"role":"user","content":"Reply with OK."}]}'

Erreurs

Une valeur invalide renvoie 400 invalid_routing_parameter. Sans tarif officiel vérifiable, la passerelle renvoie 400 official_price_unavailable. Sans fournisseur compatible avec le plafond, elle renvoie 503 no_provider_within_price_limit avant l’envoi. À l’expiration du délai, elle renvoie 504 request_deadline_exceeded avant le début de la réponse ou termine le flux en cours.