뮤즈 원더 사용법: API와 뮤즈 코드로 시작하기
뮤즈 원더(Muse Wonder) 사용법을 메타 모델 API 키 발급, 첫 호출, 뮤즈 코드 활용, 작업 1회 비용, 한국에서 아직 확인 안 된 점 순서로 정리했어요.
결론부터 말하면, 지금 뮤즈 원더를 쓰는 방법은 두 가지뿐이에요. 메타 모델 API(Meta Model API)로 직접 부르거나, 메타의 코딩 에이전트 뮤즈 코드(Muse Code) 안에서 쓰는 거예요. 뮤즈 앱에는 아직 들어가지 않았어요. 메타는 2026년 10월 12일 뮤즈 원더와 뮤즈 원더 풀을 발표하면서, 공식 발표문에서 원더는 API와 뮤즈 코드로 개발자에게 바로 제공하고, 원더 풀은 뮤즈 코드 구독자에게 제공한다고 밝혔어요.
이 글은 두 가지 방법을 단계별로 보여 주고, 흔한 작업 한 번에 드는 비용을 계산하고, 한국 사용자에게 아직 불분명한 부분을 짚어요. 2026년 10월 15일 기준 정보예요.
이름부터 정리해요
메타에는 이름에 뮤즈가 붙은 게 네 개 있어요. 뮤즈는 9월 미국에서 나온 에이전트 앱이고, 뮤즈 코드는 터미널에서 돌아가는 개발자용 도구예요. 뮤즈 원더는 모델, 그러니까 앱이나 도구 뒤에서 계산하는 두뇌고, 뮤즈 원더 풀은 그 상위 버전이에요. 뮤즈 제품군 전체는 뮤즈란에 정리돼 있어요.
핵심은 모델은 앱처럼 내려받는 게 아니라는 점이에요. 프로그램에서 불러 쓰거나, 모델이 들어 있는 도구를 쓰거나 둘 중 하나예요. 아래 두 방법이 바로 그 두 길이에요.
방법 1: 메타 모델 API로 쓰기
직접 부르는 방법이고, 구독이 아니라 쓴 만큼 내요. 메타 퀵스타트 문서에 따르면 필요한 건 모델 API 계정과, curl, 파이썬 3.9 이상, Node.js 18 이상 중 하나예요.
- 모델 API 대시보드에 로그인해서 「API keys」 메뉴를 열어요.
- 「Create API key」를 누르고, 나온 키를 바로 안전한 곳에 보관해요.
- 키는 코드에 직접 적지 말고 환경 변수 `MODEL_API_KEY`에 넣어요. macOS나 리눅스는 셸의 export로, 윈도우는 시스템 환경 변수 설정에서 하면 돼요.
- `https://api.meta.ai/v1/responses`로 요청을 보내고 모델 이름에 `muse-wonder-1.0`을 넣어요. 문서에는 추론 강도를 정하는 항목도 있고, 어려운 계획 작업에는 「high」를 예로 들어요.
- 이미 OpenAI 호환 클라이언트를 쓰고 있다면 다시 짤 필요는 거의 없어요. 뮤즈 원더 모델 페이지에 OpenAI SDK 호환 클라이언트를 메타 모델 API로 향하게 하면 된다고 적혀 있어요.
놓치기 쉬운 점이 하나 있어요. 메타 문서에서 뮤즈 원더는 프리뷰로 표시돼 있어요. 동작이나 한도, 가격이 아직 바뀔 수 있다는 뜻이에요. 시험해 보기엔 괜찮지만, 고객이 영향을 받는 업무에 넣기엔 이르다고 봐요.
처음 시험할 때 요령도 있어요. 내용을 잘 아는 문서, 예를 들어 직접 쓴 회의록을 주고 요약하게 해 보세요. 무엇을 빠뜨리는지, 무엇을 지어내는지, 답이 얼마나 긴지 바로 보여요. 모르는 자료를 맡기는 건 그다음이에요.
한 번 쓰면 얼마나 들까
메타 요금 페이지에 따르면 뮤즈 원더는 입력 100만 토큰당 4달러, 캐시된 입력은 0.20달러, 출력은 100만 토큰당 20달러예요. 컨텍스트 창은 100만 토큰이고, 가격은 달러로만 나와 있어요.
계산해 볼게요. 약 2만 토큰짜리 긴 보고서를 넣고, 2,000토큰 분량의 요약과 할 일 목록을 받는다고 해요. 입력이 0.08달러, 출력이 0.04달러라서 합쳐서 12센트예요. 비용이 커지는 건 에이전트가 오래 돌면서 중간 과정을 많이 쓰고, 매번 전체 맥락을 다시 보낼 때예요. 출력 단가가 입력의 다섯 배라서, 비용을 줄이려면 먼저 답의 길이를 줄이는 게 효과가 커요.
국내 서비스와 비교는 뮤즈 원더 vs 네이버 AI 비교에서 다뤘어요.
방법 2: 뮤즈 코드에서 쓰기
뮤즈 코드는 API 키가 필요 없어요. 퀵스타트 문서에 따르면 처음 실행할 때 로그인을 요청하고, 그다음부터는 터미널 안에서 작업해요. 모델 페이지에 따르면 기본 원더는 종량제로도, 모든 구독 요금제에서도 쓸 수 있어요. 뮤즈 코드가 어떤 도구인지는 뮤즈 코드에 자세히 정리했어요.
뮤즈 원더 풀은 뮤즈 코드 전용이고 API로는 쓸 수 없어요. 모델 페이지가 밝힌 원더 풀 포함 요금제는 월 50달러 「Power Usage」와 월 200달러 「Maximum Usage」 두 가지예요. 원더 풀의 API 가격은 공개되지 않았어요. 다른 AI 구독료와 견줘 보려면 메타 뮤즈 요금제를 참고하세요.
어느 쪽을 고를까요? 평소 터미널에서 코드를 쓰는 사람이면 뮤즈 코드가 지름길이에요. 사내 양식이나 표 계산처럼 내 도구에 원더를 붙이고 싶다면 API가 필요해요. 코딩을 전혀 안 한다면 앱에 들어올 때까지 기다리는 게 현실적이에요. AI에게 코드를 맡길 때 확인할 점은 AI한테 파이썬 코드를 부탁할 때에 있어요.
뮤즈 앱과 한국에서의 사용
메타는 원더가 「곧」 뮤즈 앱의 기능을 강화하고, 먼저 유료 사용자에게 제공된다고 했지만 시기는 밝히지 않았어요. 게다가 뮤즈 앱 자체가 한국에서는 아직 제공되지 않는다는 건 메타 뮤즈 한국 출시에서 확인했어요.
API와 뮤즈 코드를 한국에서 쓸 수 있는지는 메타 문서만으로는 알 수 없어요. 발표문에도 퀵스타트에도 지원 국가 목록이 없거든요. 가장 확실한 방법은 내 계정에서 직접 확인하는 거예요. 미국 계정이나 VPN으로 우회하는 건 권하지 않아요. 이용 약관에 어긋날 수 있고, 문제가 생겨도 기댈 곳이 없어요.
뮤즈 원더가 잘한다는 일
메타 연구 블로그와 모델 페이지에 따르면 원더는 길고 단계가 많은 작업을 위해 만들어졌어요. 계획을 세우고, 하위 에이전트에게 일을 나누고, 도구를 동시에 부르고, 실수에서 회복하는 걸 목표로 해요. 브라우저와 데스크톱, 모바일 앱도 다룰 수 있고, 「Active Memory」로 대화를 넘어 사용자 정보를 기억해요. 요청에 도구 하나만 더하면 웹 검색에 근거한 답도 할 수 있어요. TechCrunch는 메타의 첫 프런티어 모델이라고 전했어요.
다만 이건 메타의 설명이지 외부 검증이 아니에요. 실무로 보면 원더가 빛나는 건 단계가 많은 일이에요. 짧은 메일 한 통에 쓰기엔 너무 크고 비싸요.
잘 통하는 첫 지시
에이전트형 모델이 막히는 건 능력보다 지시가 흐릿해서인 경우가 많아요. 「프로젝트 계획 짜 줘」보다 이렇게 쓰는 게 잘 돼요.
이건 우리 프로젝트 보고서야. 해결 안 된 항목을 담당자와 기한을 붙여 목록으로 만들어 줘. 담당자가 안 적혀 있으면 추측하지 말고 「미정」이라고 써. 한 페이지 이내로.
효과가 있는 건 세 가지예요. 결과물 형식을 정하고, 빠진 정보를 어떻게 다룰지 정하고, 비용 상한도 되는 길이 제한을 거는 거예요. 같은 원리의 질문법은 AI 대화 잘하는 법에서 더 볼 수 있고, 원더에도 그대로 통해요.
시작하기 전에 정할 것
- 넣어도 되는 데이터. 원더는 대화를 넘어 기억해요. 고객이나 직원 정보를 넣기 전에 뮤즈 원더 개인정보를 읽어 보세요.
- 누가 확인할지. 혼자 열 단계를 나아가는 모델은 열 단계 내내 틀릴 수도 있어요.
- 예산. 에이전트를 오래 돌리기 전에 시험 한 번에 얼마까지 쓸지 정하고, 대시보드에서 사용량을 확인해요.
- 프리뷰라는 점. 조건이 바뀔 수 있는 모델 위에 멈추면 안 되는 업무를 올리지 마세요.
새 모델은 이제 거의 매주 나와요. 그래도 오래 쓸모 있는 능력은 같아요. 분명하게 부탁하고, 결과를 확인하고, 내 데이터가 어디로 가는지 아는 것. Coursium은 일에 AI를 쓰는 법을 휴대폰의 짧은 레슨으로 익히는 앱이에요.