> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Intégration Agent

> Tous les points d'entrée AIHubMix pour les AI Agents : instructions d'intégration agents.md, index machine llms.txt, guide d'appel llms.txt par modèle, Playground Skill, liens profonds Playground. Une commande copiable pour chaque entrée.

AIHubMix fournit aux AI Agents (assistants de programmation comme Claude Code, Codex, Cursor, Cline) un ensemble de points d'entrée lisibles par machine. L'Agent peut effectuer seul la découverte des modèles, la génération des appels, la vérification de la connectivité, jusqu'à vous remettre un lien Playground déjà configuré. Cette page regroupe tous les points d'entrée, avec une commande copiable pour chacun.

## Démarrage en une phrase

Envoyez la phrase suivante à votre AI Agent :

```text theme={null}
Fetch https://aihubmix.com/agents.md and follow it.
```

`agents.md` est un guide d'intégration destiné à l'exécution directe par l'Agent : vérification de la clé API, sélection d'un modèle dans le catalogue en temps réel, appel selon le protocole, vérification de bout en bout, avec une table de dépannage incluse.

## Vue d'ensemble des points d'entrée

| Point d'entrée                     | Adresse                                                     | Usage                                                                                                                 |
| ---------------------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Guide d'intégration Agent          | `https://aihubmix.com/agents.md`                            | Instructions pas à pas pour que l'Agent réalise seul l'intégration et la vérification                                 |
| Index machine du site              | `https://aihubmix.com/llms.txt`                             | Index lisible par LLM des capacités et de la documentation du site                                                    |
| Index machine de la documentation  | `https://docs.aihubmix.com/llms.txt`                        | Index complet des pages du site de documentation ; ajoutez `.md` à l'adresse de toute page pour obtenir le texte brut |
| Guide d'appel par modèle           | `https://aihubmix.com/model/{model_id}/llms.txt`            | Prix, capacités vérifiées, points de terminaison par protocole et exemples exécutables pour un modèle donné           |
| Playground Skill                   | `https://aihubmix.com/skills/playground`                    | Fichier de skill Agent pour essayer les modèles, ajuster les paramètres, comparer les modèles et générer des médias   |
| Catalogue de modèles en temps réel | `https://aihubmix.com/api/v1/models?type=llm&sort_by=order` | JSON sans authentification, avec prix et métadonnées                                                                  |

## llms.txt par modèle

Chaque modèle dispose d'un guide d'appel lisible par machine, avec le prix, la liste des capacités vérifiées, les points de terminaison des protocoles pris en charge et des exemples exécutables :

```bash theme={null}
curl -s https://aihubmix.com/model/gemini-3.7-flash/llms.txt
```

L'onglet `llms.txt` sur la page de détail d'un modèle ouvre directement le fichier correspondant. Les modèles dont la vérification n'est pas encore terminée renvoient un document d'orientation, qui pointe vers le catalogue en temps réel et le schéma des paramètres, sans aucune déclaration de capacité non vérifiée.

## Playground Skill

Confiez à votre Agent les capacités du Playground (essai de modèles, réglage des paramètres, comparaison sur un même prompt, génération d'images et de vidéos, relais par lien profond) :

```text theme={null}
Run curl -fsSL https://aihubmix.com/skills/playground and follow it.
```

Le skill est également publié à l'adresse `/.well-known/skills/aihubmix-playground/SKILL.md`, et peut être installé via le [dépôt GitHub](https://github.com/AIhubmix/skills) avec `npx skills add AIhubmix/skills`. Pour les scénarios d'intégration, utilisez le [AIHubMix API Skill](/fr/skills).

## Liens profonds Playground

L'Agent peut générer des liens directs qui vous permettent de reprendre dans le navigateur une session Playground déjà configurée :

* Comparaison multi-modèles : `https://playground.aihubmix.com/?models=gemini-3.7-flash,claude-opus-4-1` (6 au maximum)
* Accès direct à une configuration : `https://playground.aihubmix.com/?config=<JSON encodé en base64url>`, avec un JSON de la forme `{"model": "...", "proto": "chat", "params": {...}, "system": "...", "draft": "..."}` ; `draft` préremplit le champ de saisie sans envoyer le message

Les paramètres du lien sont à usage unique : ils sont effacés de la barre d'adresse dès le chargement de la page et ne transportent aucune clé.

## Génération de code

Le package npm [`@aihubmix/codegen`](https://www.npmjs.com/package/@aihubmix/codegen) fournit une génération de code programmatique pour 4 protocoles et 7 langages ; les corps de requête qu'il construit sont identiques à ceux réellement envoyés par le Playground. [`@aihubmix/model-schema`](https://www.npmjs.com/package/@aihubmix/model-schema) convertit le schéma des paramètres en entrée pour codegen.

## Questions fréquentes

### Comment l'Agent vérifie-t-il que l'intégration a réussi ?

`agents.md` contient une procédure de vérification de bout en bout : envoyer une requête minimale exigeant une réponse précise, puis contrôler le corps de la réponse et l'écho du modèle. Un HTTP 200 ne signifie pas un succès ; le contenu de la réponse doit être vérifié.

### Quels identifiants sont nécessaires pour les appels ?

Une clé API AIHubMix, transmise via la variable d'environnement `AIHUBMIX_API_KEY`, à créer dans la [console](https://console.aihubmix.com/token). N'écrivez jamais la clé dans le code, les scripts ou les conversations.

### Quels modèles sont couverts par le llms.txt par modèle ?

Les modèles vérifiés renvoient une documentation complète (la liste des capacités provient de données vérifiées officielles) ; les autres modèles renvoient un document d'orientation. La couverture s'étend au rythme des vérifications.

### Quel est l'état actuel de la prise en charge de MCP ?

Le point de terminaison MCP fournit actuellement un service de génération d'images ; l'extension des capacités est en cours. À ce stade, il est recommandé de privilégier le skill et agents.md pour l'intégration.

***

Dernière mise à jour : 2026-08-20
