OpenAI 호환 AI API 문서

익숙한 SDK, 하나의 Base URL과 API Key로 여러 AI 모델을 연동하세요.

연동 튜토리얼 열기

API Reference

첫 요청이 성공한 뒤 또는 공급자별 endpoint 세부 정보가 필요할 때 사용하세요.

30 모델 API 엔드포인트
POSTOpenAIOpenAI/chat/completions

Create Chat Completion

대화 기록으로 모델 응답을 만들며 스트리밍, 도구 호출, 사용량 집계를 지원합니다.

인증 방식

사용자 API 키를 Authorization: Bearer sk-xxxx 형식으로 전달합니다.

Authorization: Bearer sk-xxxx
Content-Type
application/json
모델 예시
gpt-4o, gpt-4.1, gpt-5, o3, o4-mini

요청 예시

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}

응답 예시

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "created": 0,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello!"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 3,
    "total_tokens": 11
  }
}

curl 예제

curl -X POST 'https://costrouter.ai/v1/chat/completions' \
  -H 'Authorization: Bearer sk-xxxx'
  -H 'Content-Type: application/json'
  -d '{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}'
파라미터
이름타입필수설명
modelstring모델 ID입니다. 백엔드가 모델명으로 사용 가능한 채널을 선택해 전달합니다.
messagesarray<object>대화 메시지 배열입니다. 보통 system, user, assistant, tool 역할을 포함합니다.
temperaturenumber아니요샘플링 온도입니다. 값이 높을수록 출력이 더 무작위적입니다.
top_pnumber아니요핵 샘플링 파라미터입니다. 보통 temperature 대신 조정합니다.
streamboolean아니요스트리밍 응답 여부입니다.
max_tokensinteger아니요최대 출력 token 수입니다.
toolsarray<object>아니요도구 또는 함수 정의입니다. 지원 여부는 상위 모델에 따라 다릅니다.
response_formatobject아니요구조화 응답 형식입니다. 지원 여부는 상위 모델에 따라 다릅니다.
응답 예시
이름타입필수설명
idstring아니요응답, 작업 또는 리소스 ID입니다.
objectstring아니요응답 객체 타입입니다.
createdinteger아니요생성 타임스탬프입니다.
modelstring아니요-
choicesarray<object>아니요모델 출력 후보입니다.
usageobject아니요token 사용량 통계입니다.

자주 발생하는 오류와 해결

첫 실행 실패는 주로 인증, 모델명, quota, 요청 형식 때문입니다.

401

인증 실패

Authorization에 Bearer와 CostRouter API Key가 함께 사용되는지 확인하세요.

403

권한 또는 잔액 부족

키 상태, 계정 잔액, 모델 접근 권한, 결제 설정을 확인하세요.

429

속도 제한

동시 요청을 줄이고 backoff로 재시도하거나 계정 제한을 확인하세요.

5xx

업스트림 또는 라우팅 실패

나중에 다시 시도하고 Usage Logs에서 요청 상태와 모델 경로를 확인하세요.

Copyright 2026 CostRouter. All rights reserved.

CostRouter는 중국 본토에 위치한 사용자의 이용을 금지합니다. 중국 본토에서의 이용이 확인되는 경우 CostRouter는 계정을 정지하거나 종료할 수 있으며, 결제된 요금 또는 잔여 잔액은 환불되지 않습니다.

문의하기

문의 내용에 가장 맞는 채널을 선택하세요.

문의하기
OpenAI 호환 API 문서 | CostRouter