> ## 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. # GPT 전체 모델 인터페이스 - Chat Completions 빠른 시작 > - OpenAI SDK 형식으로 GPT 시리즈 텍스트 모델을 호출합니다(구체적인 모델은 `model` 매개변수로 선택) - 추론 + 도구 호출 모델로, 텍스트와 이미지 혼합 입력을 지원합니다 - 동기 처리 모드로 매개변수가 간결하여 빠르게 시작할 수 있습니다 - 💡 더 많은 매개변수가 필요하신가요? [전체 매개변수 문서](./chat-completions-reference)를 확인하세요 - 💡 서버 측 도구(웹 검색, 코드 실행)가 필요하신가요? [Responses API](../responses/responses-quickstart)를 이용하세요 **BaseURL**: 기본 BaseURL은 `https://direct.evolink.ai`이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. `https://api.evolink.ai`는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다. ## OpenAPI ````yaml ko/api-manual/language-series/gpt/chat-completions/chat-completions-quickstart.json POST /v1/chat/completions openapi: 3.1.0 info: title: GPT 전체 모델 인터페이스 - Chat Completions 빠른 시작 description: OpenAI 호환 Chat Completions API로 GPT 시리즈 텍스트 모델을 호출하기 위한 빠른 시작 예제입니다. 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: Chat Completions description: OpenAI 호환 대화 완성 API paths: /v1/chat/completions: post: tags: - Chat Completions summary: GPT 빠른 대화 (전체 모델) description: >- - OpenAI SDK 형식으로 GPT 시리즈 텍스트 모델을 호출합니다(구체적인 모델은 `model` 매개변수로 선택) - 추론 + 도구 호출 모델로, 텍스트와 이미지 혼합 입력을 지원합니다 - 동기 처리 모드로 매개변수가 간결하여 빠르게 시작할 수 있습니다 - 💡 더 많은 매개변수가 필요하신가요? [전체 매개변수 문서](./chat-completions-reference)를 확인하세요 - 💡 서버 측 도구(웹 검색, 코드 실행)가 필요하신가요? [Responses API](../responses/responses-quickstart)를 이용하세요 operationId: gptChatCompletionsQuickstart requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ChatCompletionQuickRequest' responses: '200': description: 채팅 완료 성공 content: application/json: schema: $ref: '#/components/schemas/ChatCompletionResponse' '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: ChatCompletionQuickRequest: type: object required: - model - messages properties: model: type: string description: |- 호출할 모델: | 모델 ID | 컨텍스트 윈도우 | 포지셔닝 | |---|---|---| | `gpt-5.6-sol` | 1,050,000 | GPT-5.6 제품군, 최첨단 추론 | | `gpt-5.6-terra` | 1,050,000 | GPT-5.6 제품군, 균형 잡힌 프로덕션 | | `gpt-5.6-luna` | 1,050,000 | GPT-5.6 제품군, 높은 처리량과 비용 관리 | | `gpt-5.5` | 400,000 | 범용 추론 모델 | | `gpt-5.4` | 128,000 | 범용 추론 모델 | | `gpt-5.2` | 400,000 | 범용 추론 모델 | | `gpt-5.1` | 400,000 | 범용 추론 모델 | enum: - gpt-5.6-sol - gpt-5.6-terra - gpt-5.6-luna - gpt-5.5 - gpt-5.4 - gpt-5.2 - gpt-5.1 example: gpt-5.6-sol messages: type: array description: |- 채팅 메시지 목록입니다. 이미지 등 멀티모달 작성 방법은 [전체 매개변수 문서](./chat-completions-reference)를 참고하세요. ```json "messages": [ { "role": "user", "content": [ { "type": "text", "text": "이 이미지에는 무엇이 있나요?" }, { "type": "image_url", "image_url": { "url": "https://example.com/photo.png" } } ] } ] ``` items: $ref: '#/components/schemas/MessageSimple' example: - role: user content: Explain quantum entanglement in one sentence. ChatCompletionResponse: type: object properties: id: type: string description: 이번 대화의 고유 식별자 example: chatcmpl-CvJ2p8mQxK7nR4wS object: type: string enum: - chat.completion description: 응답 유형 example: chat.completion created: type: integer description: 생성 타임스탬프 example: 1786705221 model: type: string description: 실제 사용된 모델 이름 example: gpt-5.6-sol choices: type: array description: 생성 결과 목록 items: $ref: '#/components/schemas/Choice' 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: 오류 발생 시 제안 MessageSimple: type: object required: - role - content properties: role: type: string description: 메시지 역할 enum: - system - developer - user - assistant example: user content: description: '메시지 내용: 문자열 또는 콘텐츠 블록 배열(`text` / `image_url`).' example: Explain quantum entanglement in one sentence. oneOf: - type: string - type: array items: type: object Choice: type: object properties: index: type: integer description: 결과 인덱스 example: 0 message: $ref: '#/components/schemas/AssistantMessage' finish_reason: type: string description: >- 종료 이유: `stop`은 정상 종료, `length`는 최대 token 제한 도달, `tool_calls`는 도구 호출이 필요한 경우 example: stop Usage: type: object description: >- Token 사용량 통계입니다. Prompt 캐시는 자동으로 적용되며, 캐시에 적중한 입력 token은 더 저렴한 캐시 요금으로 청구됩니다. properties: prompt_tokens: type: integer description: 입력 토큰 수 example: 18 completion_tokens: type: integer description: 출력 토큰 수 (추론 토큰 포함) example: 42 total_tokens: type: integer description: 총 토큰 수 example: 60 prompt_tokens_details: type: object description: 상세 입력 토큰 정보 properties: cached_tokens: type: integer description: 캐시에 적중한 token 수 example: 0 AssistantMessage: type: object properties: role: type: string enum: - assistant example: assistant content: type: string description: 모델이 생성한 텍스트 내용 example: >- Quantum entanglement means the states of two particles are correlated, so measuring one instantly determines the state of the other. 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 ``` ````