Muse Code API 키 발급 방법: CI에서 쓰는 법과 요금 정리
Muse Code는 브라우저로도, API 키로도 로그인할 수 있고, 그 키는 Meta Model API를 쓰는 열쇠이기도 합니다. 키 발급 방법, 도구마다 필요한 환경 변수(META_API_KEY와 MODEL_API_KEY의 차이), 기본 URL, 토큰당 가격, 속도 제한, 예상치 못한 청구서로 이어지는 실수를 정리했습니다.
키 하나, 용도 두 가지
Meta Model API 키는 두 가지 일을 합니다. 하나는 Meta의 터미널 코딩 에이전트인 Muse Code에 브라우저 대신 로그인하는 것입니다. CI, 서버, 스크립트에서는 보통 이 방식을 씁니다. 다른 하나는 Muse Code가 쓰는 것과 같은 모델을 직접 작성한 코드나 다른 코딩 에이전트에서 Meta Model API로 바로 호출하는 것입니다.
헷갈리는 부분은 용도에 따라 키를 읽는 환경 변수가 다르다는 점입니다.
| 사용하는 도구 | 변수 | 참고 |
|---|---|---|
Muse Code CLI(muse, muse exec) |
META_API_KEY |
muse auth set으로 한 번 저장해 둘 수도 있음 |
| 직접 작성한 코드, OpenCode, Codex에서 쓰는 Model API | MODEL_API_KEY |
Meta 예제에서 쓰는 이름. SDK가 자동으로 읽지 않으므로 명시적으로 넘겨야 함 |
| Meta 모델로 돌리는 Claude Code | ANTHROPIC_AUTH_TOKEN |
Model API 키를 넣음 |
키 발급하기
- dev.meta.ai의 Meta Model API 대시보드에 Meta 개발자 계정으로 로그인합니다.
- API keys 탭을 열고 Create API key를 클릭합니다.
- 어디에 쓸 키인지 알 수 있는 이름을 붙입니다.
key1보다는ci-github-actions가 훨씬 낫습니다. 그다음 Create를 클릭합니다. - 바로 복사하세요. Meta는 키를 한 번만 보여 줍니다.
키는 LLM_으로 시작하고, 그 뒤에 숫자 ID와 시크릿이 이어집니다. Meta의 Business & Enterprise 가입 절차로 만든 계정은 브라우저 로그인을 아예 쓸 수 없습니다. 이 경우 Muse Code를 쓰는 방법은 API 키뿐이니 팀 관리자에게 발급을 요청하세요.
Muse Code에서 쓰기
내 컴퓨터라면 키를 한 번 저장해 두면 됩니다.
muse auth set그 밖의 환경, 특히 CI에서는 시크릿 저장소에서 META_API_KEY로 주입합니다.
META_API_KEY="$MUSE_KEY" muse exec --json "fix the failing test in tests/date.test.ts"Muse Code는 정해진 순서로 인증 정보를 찾습니다. META_API_KEY가 먼저이고, 그다음 저장된 키, 마지막으로 저장된 브라우저 세션입니다. 쓰려던 브라우저 세션이 환경 변수의 키에 가려져 있으면 Muse Code가 알려 줍니다. 세션 안에서 /login을 실행하면 로그인 방법 선택 화면이 다시 열리고, muse logout은 저장된 세션과 키를 지웁니다. 하지만 셸에서 export한 META_API_KEY는 지워지지 않으니 직접 unset해야 합니다.
CI에서 알아 둘 점이 두 가지 있습니다. muse exec는 턴이 끝나면 종료 코드 0을 반환하지만, 작업이 올바르다는 뜻은 아닙니다. 머지 여부는 자체 테스트로 판단하세요. 그리고 Linux 러너에서 샌드박스를 쓰려면 bubblewrap과 musl이 아닌 빌드가 필요합니다. Alpine 기반 이미지에서는 셸 명령이 실행되지 않습니다. muse exec의 다른 플래그는 CLI 명령어 모음에 정리해 두었습니다.
Muse Code에서 API 키를 쓰면 드는 비용
키는 종량제입니다. 모든 토큰이 월 요금제와 별도로 Model API 요금으로 청구됩니다. Meta 구독 문서에 따르면 추가 API 키를 통한 사용량은 구독 중이어도 이 방식으로 청구되므로, CI에 넣은 키가 요금제 사용량을 깎아 먹지는 않습니다. 청구는 잔액이 결제 기준액에 도달할 때, 그리고 매월 1일에 남은 금액만큼 이뤄집니다. 토큰을 어디에 썼는지는 Usage 대시보드에서 볼 수 있고, Billing 페이지의 Pay now로 미리 정산할 수도 있습니다.
키로는 안 되는 일이 두 가지 있습니다. Power와 Maximum 요금제에서만 쓸 수 있는 Muse Wonder Full에는 접근할 수 없고, 요금제에 포함된 요청 기반 사용량도 받지 못합니다.
모델별 가격
100만 토큰당 가격입니다(2026년 10월 25일 Meta 가격 페이지 기준).
| 모델 | 입력 | 캐시된 입력 | 출력 |
|---|---|---|---|
muse-wonder-1.0 |
$4.00 | $0.20 | $20.00 |
muse-spark-1.3 |
$1.25 | $0.15 | $4.25 |
muse-spark-1.3-contributor |
$0.10 | $0.002 | $0.20 |
Contributor 모델은 같은 Muse Spark 1.3을 훨씬 싼 가격에 쓰는 것으로, 대신 Meta가 데이터를 향후 모델 학습에 쓸 수 있습니다. Muse Wonder에는 Contributor 버전이 없습니다. Muse Image는 이미지당 $0.01이고, 웹 검색 그라운딩은 검색 1,000회당 $2.50이 추가됩니다. 토큰 사용량으로 월 비용을 계산하려면 요금 계산기를, 이 선택의 프라이버시 측면은 Contributor와 Standard 비교를 참고하세요.
속도 제한
제한은 키 단위가 아니라 팀 단위로 걸리므로, 키를 더 만든다고 처리량이 늘지는 않습니다.
| 모델 | 분당 요청 수 | 분당 토큰 수 |
|---|---|---|
muse-wonder-1.0 |
3,000 | 4,000,000 |
muse-spark-1.3 |
3,000 | 4,000,000 |
muse-spark-1.3-contributor |
150 | 3,000,000 |
눈여겨볼 것은 Contributor 모델의 분당 150회 요청입니다. 이 모델로 여러 에이전트를 병렬로 돌리면 여기에 걸리기 쉽습니다.
Model API 직접 호출하기
API는 다른 도구들이 이미 쓰는 형식을 지원합니다. OpenAI 방식 클라이언트라면 기본 URL은 https://api.meta.ai/v1이고, Anthropic 방식 클라이언트라면 /v1 없이 https://api.meta.ai입니다. 첫 요청은 다음과 같습니다.
curl https://api.meta.ai/v1/chat/completions \
-H "Authorization: Bearer $MODEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "muse-spark-1.3", "messages": [{"role": "user", "content": "Hello"}]}'같은 키를 문서에 있는 설정으로 OpenCode, Codex, Claude Code에서도 쓸 수 있습니다. 호출이 실패하기 시작하면 https://api.meta.ai/v1/status에서 키 없이도 API 상태와 모델별 가용 여부를 확인할 수 있습니다.
키 안전하게 관리하기
- CI의 시크릿 저장소나 비밀번호 관리자에 보관하고, 저장소나
AGENTS.md에는 절대 넣지 마세요. - 키가 놓이는 곳마다 따로 발급하세요. 그래야 CI 키가 유출돼도 노트북 쪽은 그대로 둔 채 그 키만 폐기할 수 있습니다.
- 공유 셸 프로필에서 export하지 말고, 위의
muse exec예시처럼 필요한 명령 하나에만 환경 변수로 넘기세요. - 키가 유출되면 대시보드에서 삭제하고 새로 발급하세요. 그냥 두면 내 계정에 요금이 쌓일 수 있습니다.