Skip to main content
This integration method is maintained but no longer actively developed. For the best experience and latest features, use our new AI Gateway with unified API access to 100+ models.
You can follow their documentation here: https://api-docs.x.ai/

​
Gateway Integration

1

Create a Helicone account

Log into helicone or create an account. Once you have an account, you can generate an API key.
2

Create an X AI account

Log into https://console.x.ai/ or create an account. Once you have an account, you can generate an API key from your dashboard.
3

Set HELICONE_API_KEY and XAI_API_KEY as environment variables

HELICONE_API_KEY=<your API key>
XAI_API_KEY=<your API key>
4

Modify the base URL and add Auth headers

Replace the following X AI URL with the Helicone Gateway URL:https://api.x.ai/v1/chat/completions -> https://x.helicone.ai/v1/chat/completionsand then add the following authentication headers:
Authorization: Bearer $XAI_API_KEY
Helicone-Auth: Bearer $HELICONE_API_KEY
Now you can access all the models on X AI with a simple fetch call:

​
Example

curl --request POST \
      --url https://x.helicone.ai/v1/chat/completions \
      --header "Content-Type: application/json" \
      --header "Authorization: Bearer $XAI_API_KEY" \
      --header "Helicone-Auth: Bearer $HELICONE_API_KEY" \
      --data '{
          "model": "grok-4-latest",
          "messages": [
              {
                  "role": "system",
                  "content": "You are a robot called Marvin with a brain the size of the planet."
              },
              {
                  "role": "user",
                  "content": "Say this is a test"
              }
          ],
          "temperature": 1
        }'
For more information on how to use headers, see Helicone Headers docs. And for more information on how to use X AI, see X AI Docs.