Cette page est traduite de la documentation anglaise. Les commandes, identifiants et exemples sont inchangés. Runtime 7.24.4 · SDK 2.6.7. Source anglaise

Démarrage rapide des API gratuites

Statut : actif Portée : état actuel Dernière revue : 2026-08-28 Responsable : runtime AX Code

AX Code ne fournit pas de quota de modèle. Une exécution « gratuite » utilise le quota ou les crédits offerts par un fournisseur de modèles externe, dont la disponibilité, les limites, les conditions sur les données et le catalogue de modèles peuvent changer indépendamment d’AX Code.

Chemin pris en charge le plus court : Groq

Groq est un fournisseur par défaut d’AX Code, son catalogue de modèles actuel dans AX Code contient des modèles capables d’outils, et Groq publie les limites du plan gratuit pour ces identifiants de modèles.

Créez un compte Groq et une clé d’API dans la console Groq.
Enregistrez la clé dans AX Code :

ax-code providers login groq

Confirmez les modèles disponibles dans votre version installée d’AX Code :

ax-code models groq

Ouvrez ax-code, exécutez /connect, puis choisissez Groq et l’un des modèles listés. Pour un test de fumée sans interface, le catalogue fourni actuel prend en charge :

ax-code run --model groq/openai/gpt-oss-120b "Inspect this repository without editing it and summarize its purpose."

Si ce modèle exact n’est pas affiché par ax-code models groq, utilisez un identifiant de modèle qui l’est. Le catalogue installé fait autorité pour la version installée.

Options intégrées d'offre gratuite et de crédit gratuit

Ces fournisseurs figurent dans le sélecteur de configuration par défaut d’AX Code. « Intégré » signifie qu’AX Code fournit l’adaptateur de protocole, les métadonnées de modèle, le flux d’authentifiants et le point de terminaison du fournisseur ; cela ne signifie pas que chaque modèle ou chaque requête est gratuit.

Fournisseur AX Code	Parcours sans coût	Contrainte importante
`groq`	Plan gratuit Groq	Les limites de débit sont par modèle et par compte ; consultez les limites en vigueur de Groq.
`google`	Modèles d’API Gemini de l’offre gratuite	Seuls les modèles marqués gratuits dans les tarifs de l’API Gemini sont éligibles. Google indique que le contenu de l’offre gratuite peut servir à améliorer ses produits.
`unorouter`	Identifiants de modèles se terminant par `:free`	UnoRouter est une passerelle tierce. Ses limites des modèles gratuits sont volontairement basses et la disponibilité peut fluctuer.
`huggingface`	Crédit récurrent Inference Providers	Les comptes gratuits reçoivent actuellement un petit crédit mensuel, susceptible de changer ; voir les tarifs de Hugging Face. Une tâche d’agent complète peut l’épuiser.
`zai`	Références GLM-5.3 actuelles sur l’API PAYG	Le sélecteur d’AX Code commence à GLM-5.3. Connectez le fournisseur `zai`, et non `zai-coding-plan`, et consultez les tarifs de Z.AI pour la référence sans coût en vigueur.
`openrouter`	`openrouter/free` ou une variante `:free` propre au modèle	Le préréglage du fournisseur est intégré, mais l’instantané sélectionné d’AX Code ne liste pas actuellement le routeur gratuit. Ajoutez-le explicitement, comme indiqué plus bas.

Pour UnoRouter, connectez-vous avec ax-code providers login unorouter, exécutez ax-code models unorouter et choisissez un modèle dont l’identifiant se termine par :free. Ne supposez pas que le jumeau payant, sans ce suffixe, est gratuit. Le catalogue propre d’UnoRouter note que tous les modèles gratuits ne prennent pas en charge l’appel d’outils ; AX Code n’expose que les entrées capables d’outils de son catalogue fourni.

Pour Google ou Hugging Face, connectez-vous avec l’identifiant de fournisseur correspondant, puis utilisez ax-code models google ou ax-code models huggingface. Consultez la page de tarifs en vigueur du fournisseur avant de choisir un modèle.

Ajouter le routeur de modèles gratuits d'OpenRouter

OpenRouter documente openrouter/free comme un routeur sans coût qui choisit un modèle gratuit disponible, compatible avec la requête. Comme ce routeur n’est pas dans l’instantané sélectionné actuel d’AX Code, ajoutez une entrée de modèle locale prudente au ax-code.json à la racine de votre projet (ou fusionnez-la dans votre configuration globale d’AX Code) :

{
  "$schema": "https://ax-code.app/docs-assets/schema/config.schema.json",
  "provider": {
    "openrouter": {
      "models": {
        "openrouter/free": {
          "name": "OpenRouter Free Models Router",
          "tool_call": true,
          "limit": {
            "context": 32768,
            "output": 4096,
          },
        },
      },
    },
  },
}

Les limites ci-dessus sont des valeurs budgétaires prudentes d’AX Code, pas un droit accordé par OpenRouter. Connectez ensuite et vérifiez le catalogue de modèles fusionné :

ax-code providers login openrouter
ax-code models openrouter
ax-code run --model openrouter/openrouter/free "Inspect this repository without editing it and identify its test command."

La répétition de openrouter est volontaire : le premier segment est l’identifiant de fournisseur AX Code et openrouter/free est l’ identifiant de modèle attendu par OpenRouter. La disponibilité et le choix du routeur gratuit varient selon la requête ; voir la documentation du routeur gratuit d’OpenRouter.

Utiliser le catalogue externe d'API gratuites

awesome-free-llm-apis est utile pour découvrir les offres en cours, mais ce n’est ni une liste de compatibilité AX Code ni une liste d’approbation :

Un fournisseur dans Fournisseurs et modèles pris en charge a un préréglage de configuration AX Code par défaut.
Un fournisseur seulement présent dans models-snapshot.json est appuyé sur le registre, sans être nécessairement sélectionné pour le flux de configuration par défaut.
Un autre service peut fonctionner via Fournisseurs personnalisés et passerelles lorsqu’il expose un point de terminaison compatible OpenAI ou Anthropic.
« Compatible OpenAI » est nécessaire, mais pas suffisant, pour un agent de programmation. Le modèle choisi doit aussi fournir des réponses textuelles en flux et un appel d’outils ou de fonctions fiable.
Les noms de fournisseurs, identifiants de modèles, quotas gratuits, régions et exigences de compte des listes tierces peuvent devenir obsolètes. Vérifiez-les sur les pages officielles de tarifs, de modèles et de limites de débit du fournisseur avant de vous y fier.

À la date de revue de cette page, les services nommés par ce catalogue correspondent à AX Code comme suit :

Relation avec AX Code	Services du catalogue	Signification
Préréglage de configuration par défaut	Google Gemini (`google`), Groq (`groq`), OpenRouter (`openrouter`), Hugging Face (`huggingface`), UnoRouter (`unorouter`)	Visibles dans le flux normal de configuration des fournisseurs, et traités plus haut.
Appuyé sur le registre, hors préréglage par défaut	Mistral (`mistral`), Cohere (`cohere`), Zhipu AI (`zhipuai`), AnyAPI (`anyapi`), Cerebras (`cerebras`), NVIDIA NIM (`nvidia`), Cloudflare Workers AI (`cloudflare-workers-ai`)	Des métadonnées et un adaptateur existent dans le registre fourni, mais le fournisseur ne fait pas partie du flux de configuration par défaut sélectionné. Une configuration explicite ne garantit pas qu’un modèle gratuit prend en charge les outils d’agent.
Protocole personnalisé seulement	Api.Airforce, Kluster AI, LLM7.io, Pollinations AI	Aucun préréglage AX Code. Ne configurez le point de terminaison et le modèle exacts que si l’API en vigueur est compatible avec le contrat de fournisseur personnalisé.

En particulier, le préréglage github-copilot n’est pas l’API github-models listée par certains catalogues. Ne substituez pas un identifiant de fournisseur ou un flux d’authentifiants à l’autre. Les API générales zai et zhipuai commencent à GLM-5.3 ; les anciennes références GLM 3, GLM 4, GLM-5 et GLM-5.2 restent filtrées.

Pratiques d'évaluation prudentes

Testez d’abord avec un dépôt public ou jetable. Un fournisseur ou une passerelle hébergée reçoit les invites et le contexte de code envoyés à son API.
Activez l’isolation workspace-write, ou utilisez read-only pour un test de fumée en revue seule.
Commencez par une tâche courte et un seul agent. Le conseil, l’arène, les longues sessions et les grands dépôts peuvent consommer de nombreuses requêtes et atteindre vite les limites de l’offre gratuite.
Stockez les authentifiants avec ax-code providers login ou une variable d’environnement ; ne validez jamais de clés d’API dans ax-code.json.
Traitez 429 et une indisponibilité temporaire comme des contraintes normales de l’offre gratuite. Attendez la fenêtre de nouvel essai du fournisseur, ou choisissez un autre modèle gratuit actuellement listé.