Muse Wonder와 Full, API와 Muse Code 중 어디서 쓸 수 있나?

Wonder 공식 API ID와 Full 구독 접근 권한을 구분하고 지역, 계정, 결제, 첫 요청의 요구 사항을 확인합니다.

크림색 카드에 잉크로 그린 타자기. Muse Code와 API 접근 방식의 선택을 나타냅니다.

Muse Wonder는 Meta의 Model API와 Muse Code에서 사용할 수 있습니다. Muse Wonder Full은 현재 Muse Code의 Power Usage 및 Maximum Usage 구독 혜택이며, 종량제 Model API 모델이 아닙니다.Wonder의 추론 강도를 max로 높여도 Full이 되지 않습니다.

Meta의 10월 12일 발표는 여러 제품을 한꺼번에 소개했습니다. 이 가이드는 2026년 10월 15일 확인한 공식 모델 문서를 바탕으로 각 제품의 접근 및 과금 규칙을 구분합니다. 계정을 등록하거나 구독을 구매하거나 유료 API 예시를 실행하지 않았습니다. 문서에 경로가 있다는 사실은 특정 계정의 접근 권한을 입증하지 않습니다.

작업에 맞는 경로 선택하기

경로현재 제공하는 것가정하면 안 되는 것
종량제 Model APIWonder, 정확한 ID는 muse-wonder-1.0현재 Full 종량제 API 모델은 없음
Muse CodeWonder, Power Usage 또는 Maximum Usage 구독을 통한 Full구독은 범용 API 토큰 패키지가 아님
일반 소비자용 Muse공개 예정이며 초기에는 구독자 대상“곧 제공”이 모든 계정에서 오늘 선택할 수 있다는 뜻은 아님

모델 문서는 Wonder의 입력으로 텍스트, 이미지, 동영상, 오디오, PDF를, 출력으로 텍스트를 명시합니다. 멀티모달 입력 지원이 이미지나 동영상 생성을 뜻하지는 않습니다. 1,048,576토큰 컨텍스트와 max까지의 추론 단계도 명시하지만, 이 설정만으로 실제 작업 품질이나 Full 이용 권한을 판단할 수는 없습니다.

Full 자체가 목적이라면 해당 Muse Code 구독과 실제 모델 선택 화면에서 시작하세요. muse-wonder-full 같은 API 식별자를 지어내거나, 다른 모델로 바뀔 것을 기대하며 추론 매개변수만 계속 높이지 마세요.

지역과 계정 요건부터 확인하기

가입 가이드는 만 18세 이상, 지원 지역, 계정·팀을 요구합니다. API 요청을 보내려면 필요한 결제 설정과 API 키도 갖춰야 합니다. 계정 생성만으로 API 설정이 끝나지는 않습니다.

10월 12일 업데이트된 Geographic Use Policy는 제한 지역에 홍콩·마카오를 포함한 중국과 러시아를 명시합니다. 이 지역에서의 접근뿐 아니라 해당 지역 최종 사용자에게 모델을 통합한 제품을 제공하는 행위도 제한하고, 지역 통제 우회를 금지합니다. 전체 지역과 조건은 최신 정책 전문을 읽으세요. 이 문단은 전체 국가 목록이 아닙니다.

언어가 위치를 결정하지는 않습니다. 다른 지역에 사는 중국어·러시아어 사용자도 자신의 관할 지역과 계정을 확인해야 합니다. 반대로 확인한 제한 목록에 일본이나 한국이 없다는 사실은 현지의 모든 계정, 결제 수단, 구독 혜택을 당사가 검증했다는 뜻이 아닙니다. 실제 지원 국가와 가입 규칙이 계속 적용됩니다.

위치나 용도가 제한된다면 조사 단계에서 멈추고, 그 용도가 허용된 서비스를 선택하세요. 게이트웨이, VPN, 해외 결제 수단이 원래 정책의 적용을 없앤다는 증거는 아닙니다.

Wonder 공식 API 설정

API 개요와 Create a response 참조 문서가 제시하는 경로는 다음과 같습니다.

항목문서에 명시된 값
기본 URLhttps://api.meta.ai/v1
Responses 엔드포인트POST https://api.meta.ai/v1/responses
모델muse-wonder-1.0
인증Authorization: Bearer $MODEL_API_KEY
최소 본문 필드model, input

문서에는 Chat Completions와 Messages 인터페이스도 있습니다. 문서에 나온 인터페이스 하나와 그에 맞는 요청 스키마를 선택하세요. 다른 API 계열의 본문을 붙여 넣고 URL만 바꾸면 된다고 가정하지 마세요. 일부 일반 예시는 여전히 Muse Spark를 쓰지만, 공식 개요는 Wonder용 모델을 muse-wonder-1.0으로 바꿀 수 있다고 명시합니다.

다음은 자격을 갖춘 계정을 위한 문서 기반 최소 Responses 요청입니다. 실행하면 사용 요금이 발생할 수 있습니다. 이 글을 위해 실행하지 않았습니다.키는 자신의 환경에 안전하게 설정하세요. 실제 키를 글, 스크린샷, 공유 터미널 로그에 넣지 마세요.

curl --fail-with-body -sS https://api.meta.ai/v1/responses \
  -H "Authorization: Bearer $MODEL_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"muse-wonder-1.0","input":"Reply with the word ready."}'

여기서 ready는 요청한 합격 기준이지 실제로 받은 결과가 아닙니다. Meta 문서처럼 OpenAI SDK를 쓴다면 Meta 기본 URL과 Meta 키를 모두 설정하세요. SDK의 기본 OpenAI 엔드포인트를 그대로 두면 다른 제공자에게 요청을 보내게 됩니다.

첫 요청 결과를 사실대로 확인하기

접근 확인표에 승인된 요청 전후의 확인 사항을 기록하세요. 인증 정보나 미리 성공으로 채운 결과는 들어 있지 않습니다.

호출 전에 선택한 제품, 지역 정책 확인, 계정·팀, 모델 권한, 과금 출처, 엔드포인트, 정확한 모델 ID를 기록하세요. 종량제 요청이 의도한 방식인지 확인하세요. Code 구독이 그 비용을 부담하지 않을 수 있습니다.

호출 후에는 다음을 확인합니다.

  1. HTTP 상태와 구조화된 오류. 네트워크 응답이 있다고 추론 성공은 아닙니다.
  2. 응답 상태. 미완료 또는 실패라면 세부 정보를 조사하고, 객체가 반환됐다는 이유만으로 답변 완료로 처리하지 마세요.
  3. output의 메시지 항목에 있는 텍스트와 output_text 내용. 원시 REST JSON에 최상위 답변 문자열 하나가 있다고 가정하지 마세요.
  4. 요청한 출력 작업, 제공되는 경우 반환된 모델 정보, 사용량 필드.
  5. 해당 계정의 사용량과 청구 기록. 답변만으로 어느 잔액이 쓰였는지 알 수는 없습니다.

자신의 정책이 허용한다면 민감한 정보를 지운 결과와 시각을 보관하세요. 공식 예시 응답을 Ofox가 모델을 테스트했다는 주장으로 바꾸지 마세요. 이 글은 확인 순서를 제공하며, 꾸며낸 응답 스크린샷을 제공하지 않습니다.

Muse Code 구독은 인증 정보도 다르다

구독 문서에 따르면 구독 접근은 CLI 온보딩 중 자동 연결된 인증 정보에 묶이며 Muse Code용입니다. 별도로 만든 추가 API 키는 계속 종량제로 과금됩니다. 구독 후 새 API 키로 애플리케이션을 만든다고 Code 사용 한도가 자동으로 적용되는 것은 아닙니다.

같은 문서는 구독 기본값이 콘텐츠를 학습에 사용할 수 있는 Contributor 모드라고 설명합니다. 이 모드는 끌 수 있으며, 해당 설정에서는 끈 이후의 새로운 콘텐츠를 학습에 쓰지 않습니다. 비공개 작업을 보내기 전에 현재 계정 선택과 정책을 검토하세요. Wonder의 종량제 제공 모드는 Standard입니다. 구독의 모드나 혜택이 별도의 API 키로 이전된다고 가정하지 마세요.

Full 접근은 지정된 구독 등급과 실제 온보딩 제공 여부에 달려 있습니다. 지역별 혜택이 다를 수 있습니다. 전 세계에 동일한 권한이 보장된다고 제시하지 말고 계정 화면에 표시되는 내용을 기록하세요.

모델이 없거나 요청이 실패할 때

증상다음 확인 대상판단에 필요한 증거
종량제 모델 목록에 Full이 없음제품 경로공식 안내에서 Full은 Code 구독 혜택임
Wonder 요청이 다른 제공자에게 도달기본 URL과 SDK 초기화Meta 엔드포인트와 의도한 키를 함께 설정
인증 또는 권한 실패키 유효성, 팀, 계정 접근비밀을 지운 오류와 계정 설정. 키 자체는 공유하지 않음
모델을 찾지 못함정확한 모델 ID와 지원 인터페이스공식 경로의 muse-wonder-1.0 및 계정 권한
Code 구독이 있는데 유료 API 사용 발생인증 정보의 생성 경로와 청구별도 API 키인지 온보딩 연결 Code 인증인지 구분
소비자 앱에 모델이 없음순차 출시와 계정 가용성발표문이 아닌 실제 계정 모델 선택 화면

무언가 반환될 때까지 관련 없는 식별자를 시도하지 마세요. 다른 모델을 테스트하면서 원래 질문은 해결하지 못할 수 있습니다. 첫 오류를 보존하고 설정 문제를 하나씩 바꾸세요.

출시 발표만으로 확인되지 않는 것

발표는 Active Memory와 Focus를 시스템 기능으로 설명합니다. 이는 모든 원시 API 요청이 세션 간 기억을 자동으로 유지한다는 증거가 아닙니다. 사용하는 엔드포인트와 제품의 문서에 맞춰 상태 관리를 설계하고, 자신의 승인된 테스트로 동작을 확인하세요.

마찬가지로 출시 벤치마크 주장은 특정 작업에 대한 비교가 아닙니다. 이 글은 Wonder를 다른 모델과 순위로 비교하거나 Ofox 제공 여부를 주장하거나 검증하지 않은 가격을 제시하지 않습니다. 공개 파일과 계정 접근을 구분하는 관련 사례는 Step 5 Preview 가중치와 API 경로를 참고하세요.

올바른 제품과 모델을 말할 수 있고, 적용되는 지역·계정 조건과 실제 과금 경로를 확인하며, 자신에게 허용된 접근 검사 결과를 기록하면 작업이 끝납니다. 모르는 항목은 미확인으로 남겨 두세요. 출시 발표를 배포 성공 주장으로 바꾸면 안 됩니다.