Grok 4.7 : chat de jeu de rôle sans censure et tarifs

xai/grok-4.7/chat

Grok 4.7 est le modèle de chat de xAI derrière un appel compatible OpenAI avec streaming SSE. Contexte de 500 000 tokens, réponses jusqu’à 450 000, effort de raisonnement de low à xhigh ; aucun filtre n’est ajouté sur cette plateforme.

Entrée $2Sortie $6par 1 million de tokensEntrée en cache $0.50Prompts de 200K tokens ou plusEntrée $4Sortie $12

Exécuter le modèle Voir l’API

Envoyer une requête

Les exemples suivent les paramètres publics du point de terminaison choisi. Remplacez la clé API et les médias d’exemple, puis envoyez la requête depuis votre serveur.

SDK et intégrations

POSThttps://api.spicyapi.ai/v1/chat/completions

Authentification API

Conservez la clé API dans la variable serveur SPICY_API_KEY. Utilisez l’authentification Bearer et Content-Type: application/json pour les requêtes JSON.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "xai/grok-4.7/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Généré à partir du schéma d’entrée de ce modèle, le même que l’API utilise pour valider chaque requête.

Conservez le même Idempotency-Key pour chaque requête logique. Après une coupure réseau, ne renvoyez pas automatiquement la requête avec une nouvelle clé. Gardez request_id pour retrouver la requête acceptée. Le flux de chat précédent n’est pas rejoué.

Paramètres d’entrée

Placez les paramètres du modèle au même niveau que model dans le corps JSON. Ce point de terminaison ne les encapsule pas dans un objet input.

messagesarray<object>Obligatoire

256 tours au maximum. Le contenu peut mêler blocs text et image_url dans un même message utilisateur. Le rôle système est respecté sur ce point de terminaison (nous l’avons vérifié exprès) : un cadre posé une fois en tête de fil vaut pour tout le fil.

Valeur par défaut: Non définie
Contraintes: minItems:1
maxItems:256

messages[].rolestringObligatoire dans l’objet

Role of the message author.

Valeur par défaut: Non définie
Valeurs autorisées: "system""developer""user""assistant""tool"

messages[].namestringFacultatif

Optional name identifying the speaker within its role.

Valeur par défaut: Non définie

messages[].contentstring | array | nullFacultatif

Message content, either plain text or a list of content parts.

Valeur par défaut: Non définie

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "detail": {
                "enum": [
                  "auto",
                  "low",
                  "high"
                ],
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Facultatif

Tool calls the assistant requested in this message.

Valeur par défaut: Non définie

messages[].tool_call_idstringFacultatif

Identifier of the tool call this message answers. Required on tool messages.

Valeur par défaut: Non définie

messages[].reasoning_contentstringFacultatif

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Valeur par défaut: Non définie

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    },
                    "detail": {
                      "enum": [
                        "auto",
                        "low",
                        "high"
                      ],
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobjectFacultatif

Demandez un objet JSON quand la réponse est lue par du code et non par une personne.

Valeur par défaut: Non définie

tool_choicestring | objectFacultatif

auto, none, required ou un objet qui désigne la fonction à appeler.

Valeur par défaut: Non définie

parallel_tool_callsbooleanFacultatif

true ou false, true par défaut : le modèle peut demander plusieurs appels d’outils dans un même tour. Avec false, vous obtenez au plus un appel par tour, pour les boucles où chaque appel dépend du résultat précédent. Aucun effet sur le prix.

Valeur par défaut: true

toolsarray<object>Facultatif

Jusqu’à 128 définitions de fonctions par requête. Cette génération est relativement faible sur les longues boucles agentiques.

Valeur par défaut: Non définie
Contraintes: maxItems:128

top_pnumberFacultatif

0,01 à 1. Réglez ce paramètre ou temperature, pas les deux à la fois.

Valeur par défaut: 1
Contraintes: minimum:0.01
maximum:1

temperaturenumberFacultatif

0 à 2, 0,7 par défaut. Autour de 0,9 pour varier la prose ; 0 seulement si deux exécutions ne doivent différer que sur un seul point.

Valeur par défaut: 0.7
Contraintes: minimum:0
maximum:2

max_tokensintegerFacultatif

Plafonne la réponse visible à 450 000 ; la valeur par défaut, 4 096, tronque sans prévenir une réponse longue. Les tokens de raisonnement sont facturés au tarif de sortie mais ne sont PAS soumis à ce plafond. Baissez reasoning_effort quand il vous faut un plafond prévisible.

Valeur par défaut: 4096
Contraintes: minimum:1
maximum:450000

reasoning_effortstringFacultatif

low, medium, high ou xhigh ; high par défaut. Pour le dialogue et le jeu de rôle, prenez low ou medium : high dépense des tokens de sortie à délibérer, et le texte en devient hésitant. L’effort étant facturé au tarif de sortie, ce réglage prudent coûte aussi plus cher.

Valeur par défaut: "high"
Valeurs autorisées: "low""medium""high""xhigh"

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        },
                        "detail": {
                          "enum": [
                            "auto",
                            "low",
                            "high"
                          ],
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 60,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 4096,
      "maximum": 450000,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "default": 0.7,
      "maximum": 2,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "low",
        "medium",
        "high",
        "xhigh"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "high",
      "description": "How much reasoning the model spends before answering."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-image-token-limit": 2048,
  "x-input-token-limit": 500000,
  "additionalProperties": false
}

Lire le résultat

Avec stream à false, la requête renvoie directement la réponse complète : lisez choices[].message, sans interroger de tâche. Passez stream à true si votre client gère les Server-Sent Events.

Exemple de réponse terminée

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "xai/grok-4.7/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Cette réponse n’illustre que la structure. usage donne le nombre de tokens ; la consommation et le coût réels dépendent de votre requête.

SDK et intégrations

Utilisez SpicyAPI dans votre application, terminal, assistant IA ou workflow visuel. Choisissez un guide de configuration.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Commandes de terminal et scripts d’automatisation.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instructions réutilisables pour votre assistant IA.

n8n

Nœuds communautaires pour n8n auto-hébergé et workflows HTTP Request à importer dans n8n Cloud.

ComfyUI

Workflows image, vidéo et audio sur un canevas de nœuds.

Autres intégrations

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Parcourir les workflows prêts à utiliser

C’est un modèle de conversation : il fonctionne partout où fonctionne l’API chat d’OpenAI. Gardez votre client, changez l’URL de base, désignez ce modèle par son identifiant.

Pointez ici n’importe quel client compatible OpenAI

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/xai/grok-4.7/chat

Tout outil compatible avec l’API chat d’OpenAI s’utilise de la même façon — les SDK, le Vercel AI SDK, LangChain, aider, Cline. Le serveur MCP et la CLI spicyapi prennent en charge les tâches média asynchrones. Retrouvez la configuration de chaque outil dans l’espace développeurs.

L’utiliser dans SillyTavern et les applis de jeu de rôle

Dans SillyTavern, RisuAI, Agnai ou toute appli dotée d’un réglage compatible OpenAI, collez l’URL de base ci-dessous et votre clé d’API, puis choisissez xai/grok-4.7/chat comme modèle. Les appels depuis le navigateur sont acceptés, et les curseurs que ce modèle ne prend pas en charge sont ignorés au lieu d’être refusés.

Base URL: https://api.spicyapi.ai/v1
Model: xai/grok-4.7/chat

Guide SillyTavern RisuAI, Agnai et d’autres Extension SillyTavern

À utiliser dans ComfyUI

Installez les nœuds SpicyAPI depuis ComfyUI Manager ou avec la commande ci-dessous, puis choisissez xai/grok-4.7/chat dans le nœud SpicyAPI Chat pour utiliser ce modèle dans un graphe ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Exemples de workflows Guide d’installation Code source sur GitHub

Le panneau intégré lit le même schéma que cette page : il ne peut donc pas diverger de l’API. Si votre documentation a besoin d’un contenu indexable, récupérez plutôt le JSON sous /api/embed/models/ et affichez-le vous-même.

<iframe src="https://spicyapi.ai/embed/fr/models/grok-4-7/api?model=xai%2Fgrok-4.7%2Fchat" width="100%" height="560" loading="lazy" title="Exemple de requête" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Ouvrir le panneau

Atelier

Envoyer une requête

Authentification API

Paramètres d’entrée

Lire le résultat

SDK et intégrations

L’utiliser dans SillyTavern et les applis de jeu de rôle

À utiliser dans ComfyUI