[Runyour 가이드 #4] API 라우터에서 원하는 모델 골라 호출하기

안녕하세요, Runyour 팀입니다.

AI 모델을 고를 때 이런 고민 해보신 적 있으신가요?

"이 작업엔 어떤 모델이 좋을까?"

"성능은 좋다는데 비용은 얼마나 나올까?"

"긴 문서를 넣으려면 컨텍스트가 얼마나 커야 하지?"

선택지가 많을수록 고르기는 오히려 어려워집니다. Runyour API 라우터는 이 과정을 돕기 위해 모델을 탐색하고 선택하는 방식을 새롭게 개선했습니다.

이번 가이드에서는 조건별 정렬과 필터, 목적 기반 모델 추천 기능을 활용해 내 작업에 맞는 모델을 찾는 방법을 소개합니다.

🎬 영상으로 따라 해보기

모델 목록 살펴보기부터 조건별 정렬, 목적에 맞는 모델 추천, API Key 생성까지 전체 과정을 영상에서 확인할 수 있습니다.

영상에서는 이런 내용을 확인할 수 있어요

STEP 1. 지원 모델 살펴보기

Runyour에 접속해 [API 라우터] 메뉴의 '지원 모델 보기' 탭을 엽니다.

목록에서는 각 모델의 입력·출력 단가, 컨텍스트 크기, 최대 출력을 한 화면에서 비교할 수 있습니다. 호출에 사용할 정확한 모델 ID도 함께 표시되어, 그대로 복사해 사용할 수 있습니다.

STEP 2. 조건에 맞춰 정렬하고 걸러내기

긴 목록을 처음부터 훑을 필요 없이, 필요한 기준으로 순서를 바꿔볼 수 있습니다.

• 컨텍스트 크기 순 : 긴 문서나 대용량 코드베이스를 다뤄야 할 때
• 단가 순 : 예산에 맞는 모델을 추리거나, 트래픽이 많은 기능에 붙일 모델을 고를 때
• 프로바이더별 · 유형별 : 특정 프로바이더의 모델만 보거나, 텍스트와 이미지 모델을 나눠서 확인할 때

목록형과 카드형 보기를 오가며 편한 방식으로 살펴볼 수도 있습니다.

STEP 3. 목적에 맞는 모델 추천받기

어떤 모델이 좋을지 모르겠다면, 스펙을 비교하는 대신 하려는 일에서 출발하는 방법도 있습니다.

[나에게 맞는 모델 추천]을 열고 만들고 싶은 것을 선택하면, 그에 어울리는 모델을 골라줍니다.

• 글쓰기·초안 작성 — 마케팅 카피, 이메일, 보고서 초안
• 문서 요약·정리 — 긴 회의록과 PDF·표에서 할 일 뽑아내기
• 이미지 만들기 — 광고·SNS·제품 이미지
• 분류·정보 추출 — 문의 분류와 필요한 정보만 추출
• 서비스에 AI 기능 붙이기 — 내 서비스에 대화·생성 기능 추가
• 에이전트·자동 워크플로 — 도구를 순서대로 호출하는 자동 흐름

추천된 모델에는 '자연스러운 장문 작성', '품질·비용 균형', '빠른 초안 반복'처럼 왜 이 모델인지가 함께 표시되어, 스펙을 잘 몰라도 판단하기 쉽습니다.

설정 메뉴와 항목명은 Kilo Code 버전에 따라 달라질 수 있으므로, 처음 연결한다면 영상을 함께 보며 따라 하는 것을 권장합니다.

STEP 4. API Key 생성하고 호출하기

마음에 드는 모델을 찾았다면 [API 라우터] 메뉴에서 API Key를 생성합니다.

‍API Key 하나로 159개 모델을 모두 호출할 수 있고, 모델을 바꿔도 발급한 키와 설정을 그대로 사용합니다. OpenAI 호환 인터페이스를 지원하기 때문에 기존 호출 구조를 유지한 채 model 값만 바꾸면 다른 모델로 전환됩니다.

여러 모델을 비교해 보고 가장 잘 맞는 것을 고르기까지의 부담이 크지 않다는 점도 API 라우터의 장점입니다.

Runyour 가이드 시리즈를 확인해 보세요

📍 [1편] 처음 시작하는 Runyour Agent, 회원가입부터 대시보드까지

📍 [2편] 사내 문서로 나만의 업무용 AI 에이전트 만들기

📍 [3편] VS Code에 Runyour API 연동하고 AI 코딩 시작하기

👉 [Runyour Agent 시작하기]