OpenAI 호환 AI API 문서

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

연동 튜토리얼 열기

API 레퍼런스

첫 요청이 성공한 뒤 모델 제공자별 요청 매개변수와 응답 형식을 확인할 수 있습니다.

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

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입니다. CostRouter는 이 ID를 사용해 요청과 호환되며 사용 가능한 경로를 찾습니다.
messagesarray<object>대화 메시지 배열입니다. 보통 system, user, assistant, tool 역할을 포함합니다.
temperaturenumber아니요샘플링 온도입니다. 값이 높을수록 출력이 더 무작위적입니다.
top_pnumber아니요핵 샘플링 파라미터입니다. 보통 temperature 대신 조정합니다.
streamboolean아니요스트리밍 응답 여부입니다.
max_tokensinteger아니요최대 출력 토큰 수입니다.
toolsarray<object>아니요도구 또는 함수 정의입니다. 지원 여부는 선택한 모델에 따라 다릅니다.
response_formatobject아니요구조화 응답 형식입니다. 지원 여부는 선택한 모델에 따라 다릅니다.
응답 예시
이름타입필수설명
idstring아니요응답, 작업 또는 리소스 ID입니다.
objectstring아니요응답 객체 타입입니다.
createdinteger아니요생성 타임스탬프입니다.
modelstring아니요-
choicesarray<object>아니요모델 출력 후보입니다.
usageobject아니요토큰 사용량 통계입니다.

자주 발생하는 오류와 해결

첫 요청 실패는 주로 인증, 모델 ID, 계정 잔액 또는 지출 한도, 잘못된 요청 매개변수에서 발생합니다.

401

인증 실패

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

403

접근 권한 또는 잔액 문제

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

429

속도 제한

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

5xx

모델 제공자 또는 라우팅 오류

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

Copyright 2026 CostRouter. 모든 권리 보유.

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

문의하기

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

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