> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Grok 전체 모델 인터페이스 - Responses 빠른 시작 > - OpenAI Responses API 형식으로 xAI Grok 텍스트 모델 호출 (모델은 `model` 매개변수로 선택) - 추론 + 도구 호출 모델. `grok-4.5`의 컨텍스트 윈도우는 500K 토큰 - 이 엔드포인트에서는 xAI 서버 측 도구를 사용할 수 있습니다: 웹 검색, X 검색, 코드 실행, 첨부 파일 검색, 컬렉션 검색 (성공한 호출당 과금) - 💡 도구와 전체 매개변수가 필요하신가요? [전체 매개변수 문서](./responses-reference)를 참조하세요 **BaseURL**: 기본 BaseURL은 `https://direct.evolink.ai`이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. `https://api.evolink.ai`는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다. ## OpenAPI ````yaml ko/api-manual/language-series/grok/responses/responses-quickstart.json POST /v1/responses openapi: 3.1.0 info: title: Grok 전체 모델 인터페이스 - Responses 빠른 시작 description: 서버 측 도구를 포함하여 OpenAI 호환 Responses API로 xAI Grok 텍스트 모델을 호출하는 빠른 시작 예제입니다. license: name: MIT version: 1.0.0 servers: - url: https://direct.evolink.ai description: 프로덕션 (권장) - url: https://api.evolink.ai description: 대체 URL security: - bearerAuth: [] tags: - name: Responses description: xAI 서버 측 도구를 지원하는 OpenAI Responses API paths: /v1/responses: post: tags: - Responses summary: Grok 빠른 응답 (전체 모델) description: >- - OpenAI Responses API 형식으로 xAI Grok 텍스트 모델 호출 (모델은 `model` 매개변수로 선택) - 추론 + 도구 호출 모델. `grok-4.5`의 컨텍스트 윈도우는 500K 토큰 - 이 엔드포인트에서는 xAI 서버 측 도구를 사용할 수 있습니다: 웹 검색, X 검색, 코드 실행, 첨부 파일 검색, 컬렉션 검색 (성공한 호출당 과금) - 💡 도구와 전체 매개변수가 필요하신가요? [전체 매개변수 문서](./responses-reference)를 참조하세요 operationId: grokResponsesQuick requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ResponsesQuickRequest' responses: '200': description: 응답 생성 성공 content: application/json: schema: $ref: '#/components/schemas/ResponsesResponse' '400': description: 잘못된 요청 매개변수 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 400 message: Invalid request parameters type: invalid_request_error '401': description: 인증되지 않음, 유효하지 않거나 만료된 토큰 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 401 message: Invalid or expired token type: authentication_error '402': description: 할당량 부족, 충전 필요 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 402 message: Insufficient quota type: insufficient_quota_error fallback_suggestion: https://evolink.ai/dashboard/billing '429': description: 요청 빈도 초과 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 429 message: Rate limit exceeded type: rate_limit_error fallback_suggestion: retry after 60 seconds '500': description: 내부 서버 오류 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 500 message: Internal server error type: internal_server_error fallback_suggestion: try again later '503': description: 서비스 일시적으로 사용 불가 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 503 message: Service temporarily unavailable type: service_unavailable_error fallback_suggestion: retry after 30 seconds components: schemas: ResponsesQuickRequest: type: object required: - model - input properties: model: type: string description: |- 호출할 모델: | 모델 ID | 포지셔닝 | |---|---| | `grok-4.5` | xAI 추론 + 도구 호출 모델, 컨텍스트 윈도우 500K | enum: - grok-4.5 example: grok-4.5 input: type: string description: 모델에 전달할 입력 텍스트 example: Explain what makes Grok 4.5 different in two sentences. ResponsesResponse: type: object properties: id: type: string description: 응답의 고유 식별자 example: 55d44212-8d5e-90cc-975f-36d341ce21f5 object: type: string enum: - response description: 응답 유형 example: response status: type: string description: 응답 상태 enum: - completed - incomplete - failed example: completed model: type: string description: 실제 사용된 모델 이름 example: grok-4.5 created_at: type: integer description: 생성 타임스탬프 example: 1786538000 output: type: array description: >- 출력 항목. Grok 추론 모델은 일반적으로 `reasoning` 항목(사고 과정 요약)을 먼저 반환하고, 마지막에 최종 답변이 담긴 `message` 항목을 반환합니다. items: $ref: '#/components/schemas/OutputItem' usage: $ref: '#/components/schemas/Usage' ErrorResponse: type: object properties: error: type: object properties: code: type: integer description: HTTP 상태 오류 코드 message: type: string description: 오류 설명 type: type: string description: 오류 유형 param: type: string description: 관련 매개변수 이름 fallback_suggestion: type: string description: 오류 발생 시 제안 OutputItem: type: object properties: id: type: string description: 출력 항목 식별자 type: type: string description: 출력 항목 유형 enum: - reasoning - message example: message status: type: string description: 출력 항목 상태 example: completed content: type: array description: 메시지 콘텐츠 파트(`output_text`). `message` 항목에 포함됩니다 items: type: object Usage: type: object description: 토큰 사용 통계. 프롬프트가 200K 토큰 이상이면 모든 토큰 유형이 2배로 과금됩니다. properties: input_tokens: type: integer description: 입력 토큰 수 example: 1692 output_tokens: type: integer description: 출력 토큰 수 (추론 토큰 포함) example: 54 total_tokens: type: integer description: 총 토큰 수 example: 1746 input_tokens_details: type: object description: 상세 입력 토큰 정보 properties: cached_tokens: type: integer description: 캐시에 적중한 프롬프트 토큰 수 (더 저렴한 캐시 입력 요금으로 과금) example: 512 output_tokens_details: type: object description: 상세 출력 토큰 정보 properties: reasoning_tokens: type: integer description: 추론 토큰 수 example: 35 securitySchemes: bearerAuth: type: http scheme: bearer description: |- ##모든 API는 Bearer Token 인증이 필요합니다## **API Key 받기:** [API Key 관리 페이지](https://evolink.ai/dashboard/keys)를 방문하여 API Key를 받으세요 **요청 헤더에 추가:** ``` Authorization: Bearer YOUR_API_KEY ``` ````