하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
# Base URL
https://runapi.ai
# Endpoints
POST /v1/chat/completions
POST /v1/responses
POST /v1/messages
POST /v1beta/models/{model}:generateContent
POST /v1beta/models/{model}:streamGenerateContent
curl https://runapi.ai/v1/chat/completions \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.7",
"messages": [
{
"role": "user",
"content": "이 출시 계획을 검토해 위험도가 가장 높은 가정 세 가지를 찾고, 각각에 대한 간결한 대응 방안을 제시하세요."
}
]
}'from openai import OpenAI
client = OpenAI(
base_url="https://runapi.ai/v1",
api_key="your-runapi-key"
)
response = client.chat.completions.create(
model="grok-4.7",
messages=[{"role": "user", "content": "이 출시 계획을 검토해 위험도가 가장 높은 가정 세 가지를 찾고, 각각에 대한 간결한 대응 방안을 제시하세요."}]
)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://runapi.ai/v1",
apiKey: "your-runapi-key"
});
const response = await client.chat.completions.create({
model: "grok-4.7",
messages: [{ role: "user", content: "이 출시 계획을 검토해 위험도가 가장 높은 가정 세 가지를 찾고, 각각에 대한 간결한 대응 방안을 제시하세요." }]
});개요
Grok 소개
Grok 4.5는 채팅, 코딩, 추론, 함수 도구, 구조화된 출력에 특화된 xAI 언어 모델입니다. RunAPI의 OpenAI 호환 인터페이스에서 정확한 모델 ID grok-4.5로 호출하세요.
제공사
xAI
모달리티
텍스트
Grok API 엔드포인트
| Endpoint | Protocol |
|---|---|
POST /v1/chat/completions | OpenAI compatible |
POST /v1/responses | OpenAI Responses |
POST /v1/messages | Anthropic compatible |
POST /v1beta/models/{model}:generateContent | Gemini generateContent |
POST /v1beta/models/{model}:streamGenerateContent | Gemini streamGenerateContent |
변형
| 변형 | 과금 | 요금 | |
|---|---|---|---|
| grok-4.20-0309-non-reasoning | 1K 토큰 | 입력 $1.00-$2.00 / 100만 토큰 | 출력 $2.00-$4.00 / 100만 토큰 | 보기 → |
| grok-4.3 | 1K 토큰 | 지원 종료 | 보기 → |
| grok-4.5 | 1K 토큰 | 입력 $1.60-$3.20 / 100만 토큰 | 출력 $4.80-$9.60 / 100만 토큰 | 보기 → |
| grok-4.6 | 1K 토큰 | 입력 $1.60-$3.20 / 100만 토큰 | 출력 $4.80-$9.60 / 100만 토큰 | 보기 → |
| grok-4.7 | 1K 토큰 | 입력 $1.60-$3.20 / 100만 토큰 | 출력 $4.80-$9.60 / 100만 토큰 | 보기 → |
요금
Grok 요금
| endpoint | 해상도 | 길이 | 가격 | |
|---|---|---|---|---|
| response | — | — | 입력 $1.00-$2.00 / 100만 토큰 | 출력 $2.00-$4.00 / 100만 토큰 | |
| chat_completion | — | — | 입력 $1.00-$2.00 / 100만 토큰 | 출력 $2.00-$4.00 / 100만 토큰 | |
| message | — | — | 입력 $1.00-$2.00 / 100만 토큰 | 출력 $2.00-$4.00 / 100만 토큰 |
grok-4.20-0309-non-reasoning 기준 요금입니다. 다른 변형은 각자의 endpoint 요금이 적용됩니다.
에이전트 통합
에이전트에서 Grok 실행
작동 방식
Grok 시작하기
-
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
-
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
-
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
-
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
RunAPI로 Grok을 쓰는 이유
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
Grok FAQ
Grok 4.5에는 어떤 모델 ID를 사용해야 하나요?
quickstart에 표시된 공개 모델 ID grok-4.5를 사용하세요.
Grok 4.5는 함수 도구 호출을 지원하나요?
네. OpenAI 호환 함수 정의를 `tools`에 담아 보내고, 메시지의 도구 호출에서 반환된 함수 이름과 JSON 인수를 읽으면 됩니다.
Grok 4.5는 구조화된 JSON 출력을 지원하나요?
네. 정의한 객체 구조를 따르는 기계 판독 가능한 출력이 필요할 때는 엄격한 JSON Schema를 지정한 응답 형식을 보내세요.
Grok 4.5 응답은 어떻게 스트리밍하나요?
스트리밍을 활성화하고 종료 시 `usage` 반환을 요청하세요. 종료 시 `usage` 이벤트와 마지막 완료 마커를 모두 받은 뒤에만 응답이 완료된 것으로 처리하세요.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
실패한 생성도 비용이 드나요?
실패한 생성은 과금되지 않습니다
유사 모델