문서

Amp

Amp는 모델 요청을 서버 측에서 라우팅하므로, 사용자의 컴퓨터에서 설정할 기본 URL 변수가 없습니다. Model Routing에서 Custom URL 연결을 추가하면 Amp 클라우드가 해당 엔드포인트를 호출합니다. 유료 등급에서만 사용할 수 있으므로 가장 먼저 요금제를 확인해야 합니다.

Amp의 Model Routing에서 Custom URL 연결을 추가합니다 — API 형식 chat-completions, 기본 URL https://api.kunavo.com/v1, 키는 bearer 토큰 — 옵션이 제공되는 등급에서 매핑된 모델을 하나의 키로 전환합니다

Settings → Model Routing → Add → Custom URL

Connection type    Custom URL            (Model Routing → Add)
API format         chat-completions      OpenAI Chat Completions API, the default
Base URL           https://api.kunavo.com/v1
Key                sk-kn-...             sent as Authorization: Bearer <key>
Headers            —                     nothing extra is needed
Query Parameters   —                     nothing extra is needed
Model mapping      anthropic/claude-opus-4-6 -> claude-opus-4-6
                   anthropic/claude-fable-5  -> claude-fable-5
                   openai/gpt-5.6-sol        -> gpt-5-6-sol

무엇보다 먼저 Amp 요금제를 확인하세요. Amp의 Model Routing 페이지에는 2026-09-21 기준으로 “AI 모델 라우터와 게이트웨이는 실험적 기능이며 현재 Megawatt, Gigawatt 및 Enterprise 고객만 얼리 액세스로 이용할 수 있습니다. 곧 모든 사용자에게 제공할 예정입니다.”라고 안내되어 있습니다. Custom URL 연결도 이 범주에 속하므로 Hobby 계정의 Add 메뉴에는 표시되지 않습니다. Amp는 제공 일정을 발표하지 않았으며, 이 페이지도 일정을 예측하지 않습니다.

Kunavo는 이 엔드포인트로 Amp를 실행해 테스트하지 않았습니다. 위의 모든 항목은 여기서 누군가 완료한 세션이 아니라 Amp 자체 문서를 바탕으로 한 것입니다. 이 기능은 유료 Amp 요금제에서만 사용할 수 있습니다. 따라서 이 내용은 Amp 사양을 옮긴 것으로 보아야 하며, 작동 여부는 Check Access로 확인하세요.

chat-completions는 기본 URL의 /v1 접미사를 유지합니다. Amp는 경로만 덧붙이기 때문입니다. 이를 분명히 보여 주는 것은 Amp 자체의 예시 문장입니다. “기본 URL이 https://api.example.com/v1이고 chat-completions를 사용하면 요청은 https://api.example.com/v1/chat/completions로 전송됩니다.” 같은 페이지에는 /v1로 끝나는 기본 URL도 “그대로 허용되며 중복되지 않는다”고 설명되어 있고, 연결 양식에는 입력하는 동안 요청 URL이 표시됩니다. 따라서 저장하기 전에 결합된 URL을 확인할 수 있습니다.

Amp의 Dictation 및 Realtime Voice 시스템 모델은 음성 기능이며, Kunavo는 음성-텍스트 변환 모델과 텍스트-음성 변환 모델을 제공하지 않습니다. 여기서 설정하는 Custom URL 연결은 두 기능 중 어느 것에도 사용할 수 없습니다. 해당 항목은 Amp에 맡겨 두세요.

아직 키가 없나요? Kunavo 계정을 만들고, 키를 생성한 다음(키는 sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 Amp 설정 화면에서 열립니다.

단계별 안내

/app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
개인 설정에서 Model Routing을 여세요. (워크스페이스 관리자는 Workspace Model Routing을 사용해 모든 구성원과 연결 하나를 공유할 수 있습니다.) Add 메뉴를 열고 Custom URL을 선택하세요.
API 형식을 chat-completions으로 설정하고, https://api.kunavo.com/v1을 기본 URL로 붙여 넣은 다음 sk-kn- 키를 입력하세요. Amp는 모든 형식에서 이를 Authorization: Bearer <key>로 전송하며, Kunavo는 이 헤더로 인증하므로 Headers와 Query Parameters는 비워 둡니다.
모델 매핑을 한 줄에 패턴 하나씩 입력하세요. 왼쪽은 Amp의 표준 모델 ID이고, -> 뒤의 오른쪽은 Kunavo가 받는 ID입니다. 두 표기가 다르므로(Amp는 openai/gpt-5.6-sol를 사용하고 Kunavo는 gpt-5-6-sol에 응답함) 여기서는 화살표가 필수입니다. 기억에 의존해 입력하지 말고 Models 선택기에서 표준 ID를 삽입하세요.
Check Access를 누르세요. 매핑 범위가 넓으면 Amp가 엔드포인트의 모델 목록을 표시하고, 정확히 하나의 모델을 지정하면 토큰 하나를 사용하는 요청을 보냅니다. 그런 다음 연결 목록 아래의 라우팅 그래프에서 Kunavo가 매핑한 모델을 제공하는지, 매핑하지 않은 모델은 계속 Amp로 표시되는지 확인하세요.

Amp의 Model Routing 문서에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

이것이 요약본입니다. 전체 안내—모델 선택, 실제 세션 비용, 실패 유형—는 Amp 자체 비용과 연결이 비용을 바꾸는 부분 및 바꾸지 않는 부분에 있습니다.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Amp에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

모델 ID	Kunavo 입력/출력	Amp에서의 위치
`gpt-5-6-sol`	$2.00 / $12.00	Medium 모드의 메인 에이전트와 Puck — Amp의 기본 작업 모델
`gpt-6-astra`	$4.00 / $20.00	High 모드의 메인 에이전트와 대부분의 모드에서 사용하는 Oracle 하위 에이전트
`claude-fable-5-1`	$7.00 / $35.00	Ultra 모드의 메인 에이전트. 까다롭고 범위가 정해지지 않은 작업에만 사용됩니다.
`gpt-5-6-terra`	$0.70 / $4.20	Search 하위 에이전트 — 코드베이스 검색. 처리량이 가장 큰 영향을 미치는 작업
`claude-haiku-4-5`	$0.70 / $3.50	이미지, PDF, 동영상을 위한 Amp의 모델인 View Media — Claude는 이미지를 읽지만 동영상은 읽지 않습니다.

월정액 없이 선불 잔액에서 토큰별로 청구됩니다. billing을 참고하세요. 반복되는 컨텍스트(에디터나 채팅 클라이언트가 보내는 데이터의 대부분)에서는 모델 선택보다 프롬프트 캐싱이 청구액에 더 큰 영향을 줍니다.

연결로 바뀌지 않는 항목

모델 라우팅은 토큰 비용을 청구하는 곳만 바꾸며, 그 외에는 아무것도 바꾸지 않습니다. Amp의 orb 컴퓨팅은 별도로 분당 과금되므로 연결을 추가해도 해당 비용은 그대로입니다. 웹 검색 같은 비모델 도구도 모델 라우팅 방식과 관계없이 Amp 크레딧을 계속 사용합니다. Custom URL 옵션을 이용하기 위해 필요한 Amp 구독도 첫 토큰을 사용하기 전에 발생하는 고정 비용입니다.

Amp가 기본 실행하는 모델 중 두 개는 Kunavo에서 제공하지 않으므로 위 표에 없습니다. Low 모드에서 사용하는 GLM 모델과 Read Thread 하위 에이전트입니다. 연결을 사용해도 Amp에서 설정된 최저 비용 경로를 재현할 수 없으므로 */* 매핑에서는 이 두 모델이 계속 Amp에서 실행됩니다. 이는 잘못된 설정이 아니라 올바른 결과입니다. Amp 자체 규칙에 따르면 어떤 연결도 제공하지 않는 모델은 Amp가 제공합니다.

자주 묻는 질문

Amp에서 커스텀 API 엔드포인트를 사용할 수 있나요?

예. Model Routing에서 Custom URL 연결을 사용하면 됩니다. 다만 모든 요금제에서 이용할 수 있는 것은 아닙니다. Amp의 Model Routing 문서에 따르면 Custom URL이 속한 AI 모델 라우터 및 게이트웨이 기능은 실험적 기능이며 Megawatt, Gigawatt 및 Enterprise 고객만 얼리 액세스로 이용할 수 있습니다. Amp는 곧 모든 사용자에게 제공할 예정이라고 했지만 날짜는 밝히지 않았습니다. 이는 2026년 9월 21일 기준 상황입니다. Hobby 계정의 Add 메뉴에는 이 옵션이 아예 표시되지 않으므로 기본 URL보다 먼저 요금제를 확인하세요.

Amp 기본 URL 끝에 /v1을 붙여야 하나요?

선택한 API 형식에 따라 달라집니다. 이 필드를 자주 잘못 이해하는 이유이기도 합니다. chat-completions를 선택하면 Amp는 /chat/completions만 덧붙이므로 기본 URL은 /v1 루트여야 합니다. Amp가 문서에 든 예시에서는 https://api.example.com/v1이 https://api.example.com/v1/chat/completions가 됩니다. anthropic-messages를 선택하면 Amp는 대신 /v1/messages를 덧붙이므로 경로 없이 오리진만 입력하는 것이 맞습니다. Amp는 이미 /v1로 끝나는 기본 URL도 허용하며 중복해서 붙이지 않는다고 명시합니다. 연결 양식에는 입력 중 결합된 요청 URL이 표시되므로 저장하기 전에 확인할 수 있습니다.

Amp는 커스텀 엔드포인트의 API 키를 어디에 저장하나요?

사용자의 컴퓨터가 아니라 Amp 서버에 저장합니다. Amp는 자체 클라우드에서 추론 요청을 중개하므로 Custom URL 연결은 로컬 구성 파일이나 환경 변수가 아니라 계정 설정의 Model Routing에서 구성합니다. 지정한 엔드포인트는 Amp 인프라에서 접근 가능해야 합니다. Amp는 세 가지 API 형식 모두에서 자격 증명을 Authorization: Bearer 헤더로 전송합니다. Amp가 공개한 CLI 설정 참고 문서에는 기본 URL 설정도 API 키 설정도 없습니다. 이는 클라이언트 측에서 확인할 수 있는 동일한 사실입니다.

연결을 추가한 뒤에도 Amp가 자체 모델을 사용하는 이유는 무엇인가요?

연결은 매핑에 포함된 모델만 제공하고 나머지는 Amp가 직접 제공하기 때문입니다. 다음 세 가지를 순서대로 확인하세요. 연결이 활성 상태인지, 우선순위 목록에서 어디에 있는지(개인 연결이 먼저, 그다음 워크스페이스, 마지막으로 Amp이며 우선순위 0을 먼저 시도함), 모델 매핑이 현재 모드에서 실행하는 모델과 일치하는지 확인합니다. 연결 목록 아래의 라우팅 그래프에서 모델별 제공 연결을 볼 수 있습니다. amp config model-providers check-access --provider-model은 짧은 추론 요청을 실행하고 실제로 어떤 연결이 제공했는지 보고합니다.

Kunavo가 Amp와 엔드포인트를 테스트했나요?

아니요. Kunavo는 Amp를 실제 실행 환경에서 테스트하지 않았습니다. 이 페이지는 완료된 세션의 보고서가 아니라 2026년 9월 21일 기준으로 확인한 Amp 자체 Model Routing 문서를 옮긴 내용입니다. Custom URL 기능은 유료 Amp 요금제에서만 제공되므로 여기의 항목은 실행 중인 클라이언트가 아니라 Amp의 공개 사양을 바탕으로 확인했습니다. Amp의 Check Access 버튼은 제공자와 자격 증명을 확인하는 권위 있는 테스트입니다. 이 페이지의 필드 이름이 Amp 화면과 다르면 Amp 문서를 기준으로 삼으세요.