xAI Grok API quickstart
Model IDs and access
Use an exact ID returned by your key. The public catalog does not guarantee live capacity or every optional capability.
x-ai/grok-4.5x-ai/grok-4.6x-ai/grok-4.20-0309-non-reasoningx-ai/grok-4-1-fast-non-reasoningx-ai/grok-4.7
Unprefixed compatibility IDs remain accepted; prefer the namespaced IDs returned by discovery.
export QUOTAFLOW_API_KEY="YOUR_QUOTAFLOW_API_KEY"
curl https://api.quotaflow.ai/openai/v1/models \
-H "Authorization: Bearer $QUOTAFLOW_API_KEY"
First request
OpenAI SDK base URL: https://api.quotaflow.ai/openai/v1. Keep your key on your server.
curl https://api.quotaflow.ai/openai/v1/responses \
-H "Authorization: Bearer $QUOTAFLOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "x-ai/grok-4.7",
"input": "Design an order-management API and explain its main endpoints.",
"max_output_tokens": 4096,
"stream": false
}'
Read output message items and their output_text content, or use response.output_text in the OpenAI SDK. Do not assume output[0] is text.
Responses is stateless: send the full conversation in input every time. Do not use previous_response_id, conversation, prompt, background, or store: true. Keep returned reasoning and tool-call items intact when replaying them, and include matching tool results.
Compatibility and output budgets
This Grok text integration uses /responses, not /chat/completions. Start with plain text and do not assume tools or strict JSON support. Streaming needs matching availability. Grok image generation is a separate product and is not enabled by selecting one of these text IDs.
Use the output cap for the endpoint you call; these fields are not interchangeable. If an answer ends at its output limit, inspect its status/stop reason before increasing the budget within the model limit. For streaming, consume the endpoint-specific events until completion; do not assume a first chunk is the final answer.
401 indicates an authentication problem; check key access on 403. Correct invalid request fields on 400 instead of retrying unchanged. Use bounded backoff for temporary 429/503 capacity failures. Check model access with the same key and base URL; no guide guarantees live supply or a universal price.
See Responses API, Chat Completions and billing.