OpenAI 및 Anthropic SDK로 Capriole AI 사용하기

하나의 Capriole AI API key로 Python 또는 TypeScript용 공식 OpenAI 및 Anthropic SDK를 사용할 수 있습니다. OpenAI 클라이언트는 /v1 Base URL로, Anthropic 클라이언트는 API 루트로 구성한 다음 각 SDK가 기대하는 프로토콜 네이티브 엔드포인트를 호출하세요. 개인 Premium은 월 USD 8이며, 500만 과금 API 토큰과 지원되는 Premium 모델 세트의 무제한 Browser Chat을 포함합니다. 같은 멤버십이 이 SDK를 통한 애플리케이션, 유지 중인 통합을 통한 코딩 에이전트, 브라우저의 일상 작업을 지원할 수 있습니다. 이 가이드는 두 언어에서 같은 두 요청 검사를 만듭니다. 각 예제는 OpenAI Responses 요청과 Anthropic Messages 요청을 보냅니다.

요청 경로 선택하기

클라이언트 호출	프로토콜 및 엔드포인트	Base URL	시작 모델
`openai.responses.create()`	`POST /v1/responses`	`https://api.caprioletech.com/v1`	`openai-latest`
`openai.chat.completions.create()`	`POST /v1/chat/completions`	`https://api.caprioletech.com/v1`	호환 latest 별칭 또는 모델 ID
`anthropic.messages.create()`	`POST /v1/messages`	`https://api.caprioletech.com`	`claude-latest`

Responses 네이티브 OpenAI 애플리케이션에는 Responses를 사용하세요. 기존 OpenAI 호환 애플리케이션이 해당 계약을 기대하면 Chat Completions를 사용하세요. Claude 네이티브 코드에는 Messages를 사용하세요.

시작하기 전에

활성 Premium 또는 자격 있는 Team 접근, Capriole AI API key, Python 또는 Node.js 20 이상이 필요합니다. Capriole이 새로 만든 키를 보여 줄 때 복사하세요. 전체 시크릿은 다시 표시되지 않습니다.

환경을 만들고 두 SDK 설치하기

macOS 또는 Linux에서 가상 환경을 만들고 활성화한 다음 공식 패키지를 설치하세요.

python -m venv .venv
source .venv/bin/activate
python -m pip install openai anthropic

Windows PowerShell에서는 같은 환경을 다음으로 활성화하세요.

python -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install openai anthropic

남은 단계 동안 환경을 활성화해 두세요. 설치 명령이 끝나면 두 패키지를 사용할 수 있고 의존성 오류가 없어야 합니다.

Capriole API key 설정하기

export CAPRIOLE_AI_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"

아래 프로그램은 환경에서 키를 읽습니다. 시크릿을 소스 코드에 두지 않습니다.

SDK 예제 만들기

이 파일을 capriole_sdk_example.py로 저장하세요.

import os

from anthropic import Anthropic
from openai import OpenAI


api_key = os.environ["CAPRIOLE_AI_API_KEY"]

openai_client = OpenAI(
    api_key=api_key,
    base_url="https://api.caprioletech.com/v1",
)

openai_response = openai_client.responses.create(
    model="openai-latest",
    input="Reply with OPENAI_OK and no other text.",
)
print(openai_response.output_text)

anthropic_client = Anthropic(
    auth_token=api_key,
    base_url="https://api.caprioletech.com",
)

anthropic_response = anthropic_client.messages.create(
    model="claude-latest",
    max_tokens=32,
    messages=[
        {
            "role": "user",
            "content": "Reply with ANTHROPIC_OK and no other text.",
        }
    ],
)
print(anthropic_response.content[0].text)

auth_token은 의도된 설정입니다. Anthropic SDK가 Capriole API key를 Bearer 토큰으로 보내게 합니다.

프로그램 실행하기

python capriole_sdk_example.py

성공 실행은 보통 요청한 마커인 비어 있지 않은 모델 응답 두 개를 출력합니다.

OPENAI_OK
ANTHROPIC_OK

모델이 정확한 출력 프롬프트를 항상 따르지는 않습니다. 문구가 달라도 비어 있지 않은 응답 두 개면 두 SDK 경로가 모델 출력을 반환했음을 확인합니다.

TypeScript로 같은 검사 실행하기

Node.js 20 이상을 사용하세요. 새 프로젝트에 공식 SDK와 TypeScript runner를 설치하세요.

npm init -y
npm install openai @anthropic-ai/sdk
npm install --save-dev typescript tsx @types/node

프로그램을 실행할 셸에 같은 API key를 설정하세요.

export CAPRIOLE_AI_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"

다음 파일을 capriole-sdk-example.ts로 저장하세요.

import Anthropic from "@anthropic-ai/sdk";
import OpenAI from "openai";

const apiKey = process.env.CAPRIOLE_AI_API_KEY;

if (!apiKey) {
  throw new Error("CAPRIOLE_AI_API_KEY is not set");
}

const openai = new OpenAI({
  apiKey,
  baseURL: "https://api.caprioletech.com/v1",
});

const openaiResponse = await openai.responses.create({
  model: "openai-latest",
  input: "Reply with OPENAI_OK and no other text.",
});

console.log(openaiResponse.output_text);

const anthropic = new Anthropic({
  authToken: apiKey,
  baseURL: "https://api.caprioletech.com",
});

const anthropicResponse = await anthropic.messages.create({
  model: "claude-latest",
  max_tokens: 32,
  messages: [
    {
      role: "user",
      content: "Reply with ANTHROPIC_OK and no other text.",
    },
  ],
});

for (const block of anthropicResponse.content) {
  if (block.type === "text") {
    console.log(block.text);
  }
}

다음으로 실행하세요.

npx tsx capriole-sdk-example.ts

비어 있지 않은 응답 두 개를 받아야 합니다. TypeScript 생성자는 baseURL을, Python 생성자는 base_url을 사용합니다. Anthropic 예제는 authToken 또는 auth_token을 사용해 SDK가 Capriole에 Bearer 인증을 보내게 합니다.

앱이 Chat Completions를 기대할 때 사용하기

같은 OpenAI 클라이언트가 Chat Completions 호환 엔드포인트를 호출할 수 있습니다.

completion = openai_client.chat.completions.create(
    model="google-latest",
    messages=[
        {
            "role": "user",
            "content": "Reply with CHAT_COMPLETIONS_OK and no other text.",
        }
    ],
)

print(completion.choices[0].message.content)

google-latest를 responses.create()로 옮기지 마세요. Responses 경로는 지원되는 OpenAI Responses 모델 세트를 받고, Chat Completions는 더 넓은 공개 호환 카탈로그를 받습니다.

흔한 SDK 오류 해결하기

오류	원인	해결
`KeyError: CAPRIOLE_AI_API_KEY`	환경 변수가 없음	Python을 실행하는 셸에서 키를 내보내기
`401 Missing Bearer token`	SDK가 잘못된 인증 옵션을 사용함	OpenAI는 `api_key`, Anthropic은 `auth_token` 사용
`404 Not Found`	클라이언트 Base URL의 `/v1` 경계가 잘못됨	OpenAI는 `/v1` 베이스, Anthropic은 API 루트 사용
지원되지 않는 모델	선택한 별칭이 해당 엔드포인트에 속하지 않음	Responses에는 `openai-latest`, Messages에는 `claude-latest` 사용
토큰 수 사전 검사 실패	선택한 Claude 업스트림이 Anthropic token counting을 지원하지 않음	`/v1/messages/count_tokens` 지원을 업스트림 의존으로 취급
`403` 할당량 오류	멤버십 또는 API 잔액이 요청을 승인할 수 없음	활성 멤버십과 남은 과금 토큰 잔액 검토

결과 경계 이해하기

Capriole은 SDK가 요청한 프로토콜을 유지합니다. Responses 출력은 Responses 출력으로 남고, Anthropic Messages 출력은 Messages 출력으로 남습니다. 한 계정과 잔액이 두 경로 뒤에 있지만, 응답 스키마가 서로 바꿔 쓸 수 있게 되지는 않습니다. 다중 프로토콜 API 글이 그 아키텍처를 설명합니다. 엔드포인트 필드는 Responses 레퍼런스, Chat Completions 레퍼런스, Messages 레퍼런스를 사용하세요. API 빠른 시작은 원시 첫 요청의 가장 짧은 경로입니다. 프로토콜, 별칭 또는 클라이언트 경로가 지원으로 문서화되기 전에 필요한 증거는 Capriole이 다중 모델 API 호환성을 테스트하는 방법을 읽으세요. API 호출은 과금 토큰으로 측정됩니다. 워크로드를 추정하기 전에 과금 토큰 계산 방식을 읽으세요.

공식 SDK 참고

OpenAI: Python SDK
Anthropic: Python SDK
OpenAI: TypeScript and JavaScript SDK
Anthropic: TypeScript SDK

제한된 무료 Browser Chat에서 GPT-5.6 Thinking, Claude Fable 5 또는 Gemini 3.1 Pro를 써 보세요. Python 또는 TypeScript에서 포함된 API 잔액을 쓰려면 Premium으로 업그레이드하세요. 사실 확인 날짜 2026-08-11.

​요청 경로 선택하기

​시작하기 전에

​TypeScript로 같은 검사 실행하기

​앱이 Chat Completions를 기대할 때 사용하기

​흔한 SDK 오류 해결하기

​결과 경계 이해하기

​공식 SDK 참고