Grok 4.7

요청 ID grok-4.7

프로토콜

POST /v1/responses · OpenAI Responses 예시
POST /v1/responses/compact · Responses Compact 예시
POST /v1/chat/completions · Chat Completions 예시
POST /v1/messages · Anthropic Messages 예시

인증

요청에는 API 키 관리의 API 키가 필요합니다. JSON 요청은 Content-Type: application/json을 지정하세요.

Authorization: Bearer YOUR_API_KEY
Anthropic Messages · x-api-key: YOUR_API_KEY

요청 매개변수

`POST /v1/responses`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `grok-4.7`로 설정하세요.
`input`	`string / object[]`	필수	입력 텍스트 또는 순서가 있는 입력 항목 배열입니다. 메시지 항목에는 `role`과 `content`를 사용합니다.
`input[].content[]`	`object`	조건부	이미지에는 `type: input_image` 콘텐츠 블록을 사용합니다. 허용 형식은 엔드포인트에 따라 다릅니다.
`instructions`	`string`	선택	작업과 출력 요구 사항을 지정하는 모델 지침입니다.
`max_output_tokens`	`integer`	선택	출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다.
`stream`	`boolean`	선택	`true`는 SSE 스트리밍, `false`는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다.
`store`	`boolean`	조건부	이 필드를 지원하는 경우 `false`는 나중에 조회하기 위한 응답 저장을 하지 않도록 요청합니다.
`text.format`	`object`	조건부	구조화된 출력은 `text.format`에 지정합니다. 예를 들어 `type: json_schema`를 사용할 수 있습니다. 해당 형식을 지원하는 엔드포인트에서만 사용하세요.
`temperature`	`number`	조건부	샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다.
`top_p`	`number`	조건부	누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요.
`tools`	`object[]`	조건부	모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다.
`tool_choice`	`string / object`	조건부	도구 선택을 제어합니다. 강제 호출이나 이름 지정은 해당 기능을 지원하는 엔드포인트에서만 사용하세요.

`POST /v1/responses/compact`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `grok-4.7`로 설정하세요.
`input`	`string / object[]`	필수	압축할 컨텍스트입니다. 텍스트 또는 원래 순서의 대화 입력 항목을 보내세요. 허용 형식은 엔드포인트에 따라 다릅니다.

`POST /v1/chat/completions`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `grok-4.7`로 설정하세요.
`messages`	`object[]`	필수	대화 순서대로 메시지를 보냅니다. 각 메시지에는 `role`과 `content`가 들어갑니다.
`messages[].content`	`string / object[]`	조건부	메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다.
`messages[].content[]`	`object`	조건부	이미지에는 `type: image_url` 콘텐츠 블록을 사용합니다. 허용 형식은 엔드포인트에 따라 다릅니다.
`stream`	`boolean`	선택	`true`는 SSE 스트리밍, `false`는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다.
`max_completion_tokens`	`integer`	조건부	해당하는 추론 토큰을 포함한 생성 토큰 수의 상한입니다. 이 필드를 지원하는 엔드포인트에서 사용하세요.
`max_tokens`	`integer`	조건부	출력 토큰 제한을 위한 호환 필드입니다. 엔드포인트에 따라 이 필드와 `max_completion_tokens` 중 하나를 사용하세요.
`temperature`	`number`	조건부	샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다.
`top_p`	`number`	조건부	누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요.
`response_format`	`object`	조건부	구조화된 출력에는 `type: json_object`를 사용하거나, 스키마를 지원할 때 `type: json_schema`와 `json_schema`를 함께 지정하세요.
`tools`	`object[]`	조건부	모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다.
`tool_choice`	`string / object`	조건부	도구 선택을 제어합니다. 강제 호출이나 이름 지정은 해당 기능을 지원하는 엔드포인트에서만 사용하세요.

`POST /v1/messages`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `grok-4.7`로 설정하세요.
`messages`	`object[]`	필수	`user`와 `assistant` 메시지를 순서대로 보내세요. 시스템 지침은 최상위 `system`에 넣습니다.
`messages[].content`	`string / object[]`	필수	메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다.
`messages[].content[]`	`object`	조건부	이미지에는 `type: image` 콘텐츠 블록을 사용하고 데이터를 `source`에 넣습니다. 허용 형식은 엔드포인트에 따라 다릅니다.
`system`	`string / object[]`	선택	시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다.
`max_tokens`	`integer`	필수	출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다.
`stream`	`boolean`	선택	`true`는 SSE 스트리밍, `false`는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다.
`temperature`	`number`	조건부	샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다.
`top_p`	`number`	조건부	누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요.
`tools`	`object[]`	조건부	모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다.
`tool_choice`	`object`	조건부	도구 선택을 제어합니다. 강제 호출이나 이름 지정은 해당 기능을 지원하는 엔드포인트에서만 사용하세요.

요청 예시

API Key를 로컬 환경 변수 ICODEEASY_API_KEY에 설정하고 직접 HTTP 호출을 허용하는 엔드포인트를 선택하세요. 특정 클라이언트가 필요한 경우 해당 설정 가이드를 따르세요.

OpenAI Responses

bash

curl -N -sS 'https://api.icodeeasy.cc/v1/responses' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "grok-4.7",
  "instructions": "You are a helpful assistant.",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ],
  "stream": true,
  "store": false
}'

Responses Compact

bash

curl -sS 'https://api.icodeeasy.cc/v1/responses/compact' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "grok-4.7",
  "input": "Explain how a rainbow forms in one sentence."
}'

Chat Completions

bash

curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "grok-4.7",
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ],
  "stream": false
}'

Anthropic Messages

bash

curl -sS 'https://api.icodeeasy.cc/v1/messages' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "grok-4.7",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

응답 읽기

OpenAI Responses · 스트리밍 시 response.output_text.delta 이벤트의 delta를 연결하고 완료 및 실패 이벤트를 처리하세요. SSE
Chat Completions · choices[].message.content에서 텍스트를 읽으세요. SSE 스트림에서는 choices[].delta로 새 출력이 전송됩니다. JSON · SSE
Anthropic Messages · content[]에서 유형이 text인 블록을 읽으세요. 스트리밍 시 SSE 콘텐츠 블록 이벤트를 순서대로 처리하세요. JSON · SSE

전체 연동 가이드

기능 및 제한

streaming · 지원
tool_calling · 지원
image_input · 조건부 지원 — 호환 엔드포인트와 요청 형식에 따라 달라집니다
video_input · 미지원

호환 별칭 및 은퇴 리디렉션

grok-4.5 → grok-4.7 (별칭)

모델 기능 카탈로그 · 가격 보기

Grok 4.7 API 및 Claude Code 설정 가이드

I Code Easy API Key로 macOS, Linux, Windows의 Claude Code에 Grok 4.7을 설정합니다. 연결 확인과 인증·모델 오류 해결, Imagine 이미지·동영상과의 차이를 안내합니다.

OpenAI Responses

OpenAI Responses 형식으로 입력을 보냅니다. 예시는 HTTP 스트리밍을 사용합니다. Codex 설정은 관련 가이드를 참고하세요.

Codex config.toml 고급 가이드

Codex config.toml의 모델, 추론 강도, 인증 저장소, provider, profiles와 호환 설정을 조정하고 폐기된 필드를 피합니다.

가입하고 API Key 받기