메인 콘텐츠로 건너뛰기
OrcaRouter는 OpenAI 호환 인터페이스를 일급 수준으로 제공합니다. 기존 OpenAI SDK를 OrcaRouter의 base URL로 가리키면 SDK가 기대하는 방식대로 코드가 그대로 동작합니다 — 스트리밍, 도구 호출, 구조화 출력(json_object과 json_schema), 비전이 모두 지원됩니다. 다른 프로바이더의 모델을 대상으로 지정하면 OrcaRouter의 변환층이 요청과 응답을 해당 프로바이더의 네이티브 형태로 적응시키므로 SDK 코드는 그대로 둬도 됩니다.

​
Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.orcarouter.ai/v1",
    api_key="sk-orca-...",
)

​
TypeScript / Node

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://api.orcarouter.ai/v1",
  apiKey: "sk-orca-...",
});

​
비동기 Python

from openai import AsyncOpenAI

client = AsyncOpenAI(
    base_url="https://api.orcarouter.ai/v1",
    api_key="sk-orca-...",
)

​
환경 변수 사용

OpenAI SDK는 기본적으로 OPENAI_API_KEY와 OPENAI_BASE_URL을 읽습니다. 한 번 설정하면 호출별 설정 없이 SDK가 자동으로 가져 갑니다: 
export OPENAI_API_KEY="sk-orca-..."
export OPENAI_BASE_URL="https://api.orcarouter.ai/v1"

​
코드에서 바뀌는 것

base URL과 API 키뿐입니다. 요청 매개변수, 응답 형식, 스트리밍 프로토콜, 오류 처리는 모두 그대로입니다. 모델 이름은 프로바이더 접두사가 붙어 있어서(openai/gpt-4o-mini, anthropic/claude-sonnet-4.6, google/gemini-2.5-pro, deepseek/deepseek-chat, grok/grok-4-fast-reasoning, qwen/qwen3.6-plus, kimi/kimi-k2.6, minimax/minimax-m2.7) 어느 프로바이더가 요청을 처리했는지 클라이언트에서 항상 알 수 있습니다; OrcaRouter는 동일한 클라이언트 객체를 통해 프로바이더 간 변환을 내부적으로 처리합니다.

​
web_search를 추가하고 싶다면?

OpenAI SDK로 OrcaRouter에 대해 웹 검색이 작동합니다. 엔드포인트별 매개변수 형태와 지원 모델은 고급 기능 / 웹 검색을 참조하세요.

​
다른 SDK

Anthropic SDK나 google-genai SDK를 직접 사용 중이라면 호환성 / Anthropic SDK와 호환성 / Google GenAI SDK를 참조하세요.