30 모델 API 엔드포인트

OpenAI 호환 AI API 문서

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

명령 하나로 코딩 에이전트 연결

터미널 명령 하나로 Codex, Claude Code, Gemini CLI 또는 Cursor를 CostRouter에 연결해 테스트하세요. 연결을 확인한 뒤 영구 설정을 저장하면 됩니다.

연동 튜토리얼 열기

API 레퍼런스

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

30 모델 API 엔드포인트
GETOpenAIOpenAI/models

모델 목록 조회

현재 사용 가능한 OpenAI 형식 모델을 보여줍니다. CostRouter는 헤더에 따라 Anthropic 및 Gemini 모델 목록 요청도 분기합니다.

첫 단계로 권장

curl로 첫 번째 요청을 실행하세요

sk-xxxx를 전체 API Key로 바꾼 뒤 코드 블록 전체를 macOS 또는 Linux 터미널에 한 번에 붙여 넣고 Enter를 누르세요. 정상 응답을 확인한 다음 아래 안내에 따라 코드, SDK 또는 클라이언트를 설정하세요. 각 줄 끝의 백슬래시는 삭제하지 말고 뒤에 공백도 추가하지 마세요.

curl 예제

curl -X GET \
  "https://costrouter.ai/v1/models" \
  -H "Authorization: Bearer sk-xxxx"

테스트 성공 후: 실제 연동을 설정하세요

사용 중인 요청 도구, 코드, SDK 또는 외부 클라이언트에 맞는 방식을 선택한 뒤 아래 요청 정보를 이용해 연동을 완료하세요.

도구 또는 코드에서 요청을 설정합니다

요청의 Headers 설정을 열고 항목을 하나 추가하세요. 왼쪽에는 아래 헤더 이름을, 오른쪽에는 헤더 값을 입력합니다.

헤더 이름 입력
Authorization
헤더 값 입력
Bearer sk-xxxx
앱 또는 SDK에 키를 입력합니다

앱에서 API Key, Token 또는 Secret 입력란을 찾아 sk-xxxx와 같은 전체 키를 붙여 넣으세요. Authorization이나 Bearer는 함께 입력하지 마세요.

API Key / Token 입력란에 붙여넣기
sk-xxxx
Content-Type
N/A
모델 예시
gpt-5.6-luna, gpt-5.6-terra, gpt-5.6-sol, gpt-5.4-mini, gpt-image-2

응답 예시

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.6-luna",
      "object": "model",
      "owned_by": "openai"
    }
  ]
}
파라미터
이름타입필수설명
필수 파라미터가 없습니다.
응답 예시
이름타입필수설명
dataarray<object>아니요결과 배열 또는 제공자 응답 데이터입니다.

자주 발생하는 오류와 해결

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

401

인증 실패

HTTP 요청을 직접 보낼 때는 인증 헤더와 전체 키를 확인하세요. SDK의 API Key 입력란에는 Bearer 없이 sk-xxxx만 입력합니다.

403

접근 권한 또는 잔액 문제

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

429

속도 제한

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

5xx

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

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

Copyright 2026 CostRouter. 모든 권리 보유.

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

문의하기

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

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