Grok API

Grok API через cURL

View as Markdown

Обновлено:

Минимальная рабочая интеграция Grok API Dev через cURL: обычный запрос, JSON-ответ, streaming и диагностика HTTP-ошибок.

Подготовка API-ключа

Bash
curl --version
Bash
export GROK_API_DEV_KEY="sk-lg-YOUR_API_KEY"

Первый запрос к Grok API Dev

cURL
curl --fail-with-body https://api.llm-gate.tech/v1/responses \
  -H "Authorization: Bearer $GROK_API_DEV_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Explain HTTP in two sentences"
  }'

Формат ответа

JSON
{
  "id": "resp_01abc",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "HTTP is..." }
      ]
    }
  ],
  "usage": {
    "input_tokens": 12,
    "output_tokens": 34,
    "total_tokens": 46
  }
}

Streaming

cURL streaming
curl -N --fail-with-body https://api.llm-gate.tech/v1/responses \
  -H "Authorization: Bearer $GROK_API_DEV_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Write a short example",
    "stream": true
  }'

Обработка ошибок

Флаги --fail-with-body и -i помогут увидеть HTTP-статус, заголовки и JSON-тело ошибки.

cURL
curl -i --fail-with-body https://api.llm-gate.tech/v1/responses \
  -H "Authorization: Bearer $GROK_API_DEV_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Test request"
  }'
  • 401: проверьте GROK_API_DEV_KEY и заголовок Authorization.
  • 404: проверьте ID модели и путь /v1/responses.
  • 429: дождитесь Retry-After и уменьшите частоту запросов.
  • 500, 504 или 529: ограниченно повторите запрос с backoff и jitter.

Полный список кодов и способы их обработки собраны на странице «Ошибки API».

Связанные страницы

Messages APIStreaming APIPythonTypeScript