# xAI SDK

Les outils pour développeurs. Fiche « Apps et logiciels d'IA » de QUELLE IA, d'après les pages officielles (octobre 2026). Page : https://quelleia.com/logitheque/xai-sdk/

## Télécharger

- Linux : Gestionnaire de paquets, https://pypi.org/project/xai-sdk/ (pip install xai-sdk ; Python 3.10 ou plus récent)
- Mac : Gestionnaire de paquets, https://pypi.org/project/xai-sdk/ (pip install xai-sdk ou uv add xai-sdk ; Python 3.10 ou plus récent)
- Windows : Gestionnaire de paquets, https://pypi.org/project/xai-sdk/ (pip install xai-sdk ; Python 3.10 ou plus récent)
- Linux : Dépôt officiel, https://github.com/xai-org/xai-sdk-python (Code source et versions sur GitHub)
- Linux : Dépôt officiel, https://github.com/xai-org/xai-sdk-ts (SDK TypeScript officiel, expérimental (paquet npm @xai-official/sdk) ; Node.js 22.13 ou plus récent)

## En bref

Le SDK Python officiel de xAI donne accès depuis un programme aux modèles Grok : texte, raisonnement, sorties structurées, appels de fonctions, génération d'images et de vidéos. Il repose sur gRPC et propose des clients synchrone et asynchrone. xAI publie aussi un SDK TypeScript, encore expérimental ; les deux sont sous licence Apache 2.0.

Pourquoi il est là : C'est la bibliothèque maintenue par xAI pour appeler les modèles Grok et Imagine depuis Python.

- Éditeur : xAI, États-Unis
- Prix : Bibliothèque libre ; l'usage de l'API est payé à la consommation (par exemple grok-4.7 : 2 $ par million de jetons en entrée et 6 $ en sortie sous 200 000 jetons)
- Licence : open source (Apache-2.0)
- Fonctionnement : En ligne. Le SDK appelle l'API de xAI sur api.x.ai ; les modèles tournent sur les serveurs de l'éditeur.
- Systèmes : Mac, Windows, Linux

## À quoi ça sert

- Construire un chatbot qui garde l'historique d'une conversation à plusieurs tours.
- Générer ou modifier des images et des vidéos avec les modèles Grok Imagine.
- Faire appeler ses propres fonctions par le modèle, ou obtenir des réponses dans un format structuré.
- Confier une demande de code à grok-4.7, le modèle qui fait aussi tourner Grok Build.

## Fonctions

- **Clients synchrone et asynchrone** : xai_sdk.Client et xai_sdk.AsyncClient, avec la clé lue dans la variable XAI_API_KEY.
- **Conversation** : Objet chat auquel on ajoute les messages avant de demander une réponse.
- **Images et vidéos** : Génération et édition par les modèles Imagine.
- **Appels de fonctions et sorties structurées** : Outils définis par le développeur et réponses au format imposé.
- **SDK TypeScript** : Client ESM sans dépendance : API Responses, images et vidéos, fichiers, lots, voix ; expérimental.

## Pour qui

Les développeurs qui intègrent Grok dans une application ou un script, avec une clé d'API xAI.

## Ce qu'il faut savoir

- Compte : Un compte sur console.x.ai, approvisionné en crédits, et une clé d'API sont nécessaires.
- À noter : L'API de xAI accepte aussi les SDK d'OpenAI et le Vercel AI SDK, que la documentation cite à côté du SDK maison.
- Limites : Le SDK TypeScript est déclaré expérimental et ne couvre pas encore toute l'API.
- À noter : Les modèles arrivent parfois plus tard en Europe : Grok 4.5 n'a été ouvert aux utilisateurs de l'UE dans la console qu'après sa sortie.
- Configuration demandée par l'éditeur : Python 3.10 ou plus récent ; SDK TypeScript : Node.js 22.13 ou plus récent.

## Modèles

Tous les modèles de l'API xAI : Grok pour le texte, Grok Imagine pour les images et vidéos, Grok Voice pour la voix.

- [grok-4.7](https://quelleia.com/modeles/grok-4-7/)
- [grok-4.6](https://quelleia.com/modeles/grok-4-6/)
- grok-imagine-image-2.0
- grok-imagine-video-1.5
- grok-voice-3.0

## Sur QUELLE IA

- [Grok 4.7](https://quelleia.com/modeles/grok-4-7/) : Un modèle que xAI SDK propose : son score, ses forces, ce qu'il demande.
- [Grok 4.6](https://quelleia.com/modeles/grok-4-6/) : Un modèle que xAI SDK propose : son score, ses forces, ce qu'il demande.
- [Les outils de code](https://quelleia.com/outils/) : Pour aller plus loin sur l'usage « pour les développeurs ».
- [Le classement du code](https://quelleia.com/classement/code/) : Pour aller plus loin sur l'usage « pour les développeurs ».
- [Quel modèle tient sur ma machine](https://quelleia.com/local/) : Pour aller plus loin sur l'usage « pour les développeurs ».
- [L'éditeur xAI](https://quelleia.com/editeurs/xai/) : Ses modèles, leurs scores, ses abonnements.

## Sources

- https://github.com/xai-org/xai-sdk-python
- https://github.com/xai-org/xai-sdk-ts
- https://docs.x.ai/developers/quickstart
- https://docs.x.ai/developers/model-capabilities/imagine
- https://docs.x.ai/developers/release-notes
- https://play.google.com/store/apps/details?id=ai.x.grok&hl=fr&gl=FR
- https://pypi.org/project/xai-sdk/
- https://github.com/xai-org/xai-sdk-python/blob/main/LICENSE
- https://docs.x.ai/overview
- https://github.com/xai-org/xai-sdk-python/releases