Choose a model
Muse Wonder, Muse Spark, and Muse Ember are reasoning models that take the same requests on the same endpoints, so moving a workload between them is a model ID change. Pick one by what each part of your app needs — or run them together in the same agent.
Compare the models
| Muse Wonder | Muse Spark | Muse Ember | |
|---|---|---|---|
| Built for | Complex software engineering and long-horizon agentic work | Agentic and coding work at scale | Efficient execution of high-volume, repeated work |
| Use it when | Capability matters more than cost per token | The main loop or a harder task needs strong reasoning at a lower cost than Muse Wonder | A larger model plans, and sub-agents run many bounded tasks |
| Model IDs | muse-wonder-1.0 | muse-spark-1.3 (recommended), muse-spark-1.2, muse-spark-1.1 | muse-ember-1.0 |
| Input | Text, image, video, audio, and PDF | Text, image, video, audio, and PDF | Text, image, video, audio, and PDF |
| Context window | 1,048,576 tokens | 1,048,576 tokens | 1,048,576 tokens |
| Reasoning effort | "minimal" to "max"; default "max" | "minimal" to "max" on muse-spark-1.3; default "high" | "minimal" to "max"; default "max" |
| Contributor mode on Model API | Not available | muse-spark-1.3-contributor, muse-spark-1.2-contributor | Not available |
| Pricing | Muse Wonder pricing | Muse Spark pricing | Muse Ember pricing, with long-context rates over 200K input tokens |
| Availability | Muse Wonder availability | Muse Spark availability | Muse Ember availability |
Choose by workload
| Workload | Model |
|---|---|
| Multi-file coding changes in a real repository | Muse Wonder |
| Multi-hour agent runs and sub-agent orchestration | Muse Wonder |
| The main loop of a coding agent or agent framework | Muse Wonder |
| Computer use | Muse Wonder, or Muse Spark or Muse Ember at lower cost |
| A lower-cost main loop for agents and assistants | Muse Spark |
| Knowledge-heavy questions answered without retrieval | Muse Spark or Muse Wonder |
| Sub-agent tasks handed out by a main agent, including coding subtasks | Muse Ember |
| Tool calls, tight tool loops, and latency-sensitive turns | Muse Ember |
| Classification, routing, and other high-volume requests | Muse Ember |
| Running the same task over thousands of images, files, or records | Muse Ember |
| Discounted prices on Model API in Contributor mode | Muse Spark, through a Contributor-mode variant |
| Audio understanding | Muse Spark 1.2 |
| Speech to text | Muse Voice Transcribe |
| Image generation and editing | Muse Image |
| Image and video segmentation | Segment Anything Model |
Combine models in one agent
Most agents don't need one model for everything. Put Muse Wonder on the main loop, where planning and multi-step reasoning decide the outcome, or Muse Spark when the main loop needs to cost less. Put Muse Ember on sub-agents and background tasks, which run many short, focused jobs where cost adds up: the larger model plans, and Muse Ember handles the volume.
The harnesses you already use support this split:
- Claude Code and the Claude Agent SDK: map the
opusalias tomuse-wonder-1.0, thesonnetalias tomuse-spark-1.3, and thehaikualias and sub-agent model tomuse-ember-1.0. See Set up Claude Code and Build with the Claude Agent SDK. - Codex: set
muse-wonder-1.0as the default model, and switch tomuse-spark-1.3for faster, lower-cost sessions. See Set up Codex. - Your own agent loop: pass a different
modelon each request. The reasoning models accept the same request body; Switch between models lists the few settings that differ.
Switch between models
Moving a workload from one model to another is a model ID change. Keep these differences in mind:
- Reasoning effort:
muse-wonder-1.0,muse-spark-1.3, andmuse-ember-1.0accept"minimal"to"max"."max"isn't available onmuse-spark-1.2,muse-spark-1.1, ormuse-spark-1.3-contributor. When a request sets no effort, Muse Wonder and Muse Ember use"max"and Muse Spark uses"high"; see Reasoning. - Contributor mode: on Model API, only Muse Spark has Contributor-mode variants. Muse Wonder and Muse Ember are Standard mode only; see Muse Wonder availability and Muse Ember availability.
- Muse Wonder Full: the higher-capability variant of Muse Wonder is available only in Muse Code, so no model ID on Model API selects it; see Muse Wonder availability.
- Audio input: response quality for audio on Muse Spark 1.3 may be degraded. Use Muse Spark 1.2 or Muse Voice Transcribe instead.
- Long-context pricing: Muse Wonder and Muse Spark charge the same rate at any context length. Muse Ember bills a request with more than 200K input tokens at long-context rates, so compare costs at your real input sizes; see Muse Ember pricing.
- Harder work: for hard single-shot coding problems, knowledge-heavy questions, or visual coding, use Muse Spark or Muse Wonder rather than Muse Ember.
Next steps
- Wire the main-loop and sub-agent split into your own code with an agent framework.
- Check what each split costs in Pricing and rate limits.