Skip to main content
POST
Grok Responses (tous modèles, paramètres complets)
BaseURL : La BaseURL par défaut est https://direct.evolink.ai, qui offre une meilleure prise en charge des modèles de texte et des connexions persistantes. https://api.evolink.ai est le point d’accès principal pour les services multimodaux et sert d’adresse de secours pour les modèles de texte.
Les outils côté serveur s’exécutent sur l’infrastructure de xAI et sont facturés par appel réussi, en plus de la consommation de tokens : recherche web / recherche X / exécution de code 0.005parappel,recherchedepieˋcesjointes0.005 par appel, recherche de pièces jointes 0.01 par appel, recherche de collections $0.0025 par appel. Les frais d’outils ne sont pas affectés par le multiplicateur de contexte long.
image_generation n’est actuellement pas disponible sur Grok 4.5 : sa déclaration est acceptée par compatibilité, mais l’outil est supprimé avant que la requête n’atteigne le modèle. Les valeurs tools[].type non reconnues sont rejetées avec un 400.

Autorisations

Authorization
string
header
requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Corps

application/json
model
enum<string>
requis

Modèle à appeler :

Options disponibles:
grok-4.5
Exemple:

"grok-4.5"

input
requis

Entrée pour le modèle : une chaîne simple, ou un tableau d'éléments d'entrée OpenAI Responses (par ex. {"role":"user","content":[...]}), transmis tel quel.

Exemple:

"Search the web for the latest SpaceX launch and summarize it in one sentence."

stream
boolean
défaut:false

Indique s'il faut renvoyer une réponse en streaming (événements SSE, se terminant par response.completed). Par défaut false.

Exemple:

false

max_output_tokens
integer

Nombre maximal de tokens à générer (tokens de raisonnement inclus).

Exemple:

2048

tools
object[]

Déclarations d'outils. Outils côté serveur de xAI (facturés par appel réussi, frais non affectés par le multiplicateur de contexte long) :

Les outils function classiques (appels de fonctions côté client) sont également pris en charge et n'entraînent aucun frais par appel.

⚠️ image_generation n'est actuellement pas disponible : sa déclaration est acceptée par compatibilité, mais l'outil est supprimé avant que la requête n'atteigne le modèle. Les types d'outils non reconnus sont rejetés avec un 400.

Exemple:
tool_choice

Contrôle la sélection de l'outil : "auto" (par défaut) / "none" / "required", ou un objet imposant un outil précis, par ex. {"type": "web_search"}.

Options disponibles:
auto,
none,
required
max_tool_calls
integer

Nombre maximal d'appels d'outils côté serveur pour cette requête. En l'absence de valeur (ou avec null), la plateforme applique automatiquement un plafond pouvant aller jusqu'à 10 appels selon votre solde disponible. Les outils payants déclarés réservent à l'avance leur budget dans le pire des cas ; la partie non utilisée est remboursée lors du règlement.

Exemple:

5

Réponse

Réponse générée avec succès (objet JSON, ou flux d'événements SSE se terminant par response.completed lorsque stream=true)

id
string

Identifiant unique de la réponse

Exemple:

"55d44212-8d5e-90cc-975f-36d341ce21f5"

object
enum<string>

Type de réponse

Options disponibles:
response
Exemple:

"response"

status
enum<string>

Statut de la réponse

Options disponibles:
completed,
incomplete,
failed
Exemple:

"completed"

model
string

Nom du modèle réellement utilisé

Exemple:

"grok-4.5"

created_at
integer

Horodatage de création

Exemple:

1786538000

output
object[]

Éléments de sortie dans l'ordre de génération : éléments reasoning (résumé du raisonnement), éléments d'appel d'outils côté serveur tels que web_search_call / code_interpreter_call (le statut completed indique un appel réussi et facturable), puis un élément message final avec un contenu output_text.

usage
object

Statistiques d'utilisation des tokens et des outils. À partir de 200K tokens dans le prompt, tous les types de tokens sont facturés au double ; les frais d'outils ne sont pas affectés par ce multiplicateur.