로그인
API 문서

API Reference

각 모델 제공사의 공식 API와 호환되는 요청 형식으로 모델 서비스를 호출합니다.

30
모델 API 엔드포인트
8
카테고리
API Key
인증 방식

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 사용량 통계입니다.

핵심 개념

연동을 디버깅하기 전에 신규 사용자가 이해해야 할 항목입니다.

API Key: CostRouter 키가 지원 모델 요청을 인증합니다.
Base URL: 공급자 URL을 CostRouter relay URL로 교체합니다.
Model name: payload의 모델명을 유지하면 CostRouter가 사용 가능한 채널을 선택합니다.
Usage and billing: 요청 완료 후 Usage Logs와 Billing에 비용이 표시됩니다.

모델 선택

어떤 endpoint로 시작할지 모를 때는 다음 기준을 사용하세요.

일반 chat: gpt-4o-mini 또는 다른 저비용 chat 모델로 시작하세요.
추론 또는 코드: 기본 요청이 성공한 뒤 더 강한 모델을 선택하세요.
이미지, 오디오, 비디오: API Reference의 해당 endpoint 카테고리를 사용하세요.
가격 확인: 운영 트래픽 전 Models에서 그룹과 요금을 비교하세요.

자주 발생하는 오류와 해결

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

401

인증 실패

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

403

권한 또는 잔액 부족

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

429

속도 제한

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

5xx

업스트림 또는 라우팅 실패

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

문의하기

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

문의하기
API 문서 - CostRouter