> ## Documentation Index
> Fetch the complete documentation index at: https://docs.summerengine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Summer API quickstart for Codex

> Connect Codex to the Summer API in one command, sign in once with a spend limit, and let it make 3D models, images, video, voice, sound and music for your game.

Codex (the CLI or the app) makes your game's assets through the Summer API: 3D models, images, video, voice, sound effects and music, saved straight into your project.

**1. Connect**

```bash theme={null}
npx -y summer-engine@latest setup codex --yes
```

This adds Summer's MCP server to `~/.codex/config.toml` and installs the `summer-api` skill in `~/.agents/skills`. Start a new Codex session after it runs.

**2. Sign in once**

```bash theme={null}
npx -y summer-engine@latest login
```

The browser opens the Summer sign-in page. Sign in with your Summer account, pick a spend limit for this agent and choose **Allow**. The sign-in renews itself, so you do this once per computer. There are no API keys to copy.

**3. Ask for assets**

Ask in plain words, in your project folder:

```text Prompt wrap theme={null}
Use the Summer API to make a low-poly wooden barrel, a red health potion icon with a transparent background, and a short sword-swing sound for my game. Estimate first, tell me the total, then save the files in assets/.
```

The agent uses the `summer-api` skill: it picks a model for each asset, prices the jobs with `summer api estimate`, asks you, then runs them with `summer api run --download assets` (or `--batch` for many). Every file is also saved to your Summer library.

> [!TIP]
>
> Codex can also use the hosted Summer MCP, with no local install: `codex mcp add summer-cloud --url https://mcp.summerengine.com/mcp`, then `codex mcp login summer-cloud`.

## What it costs

Every model has one public price: per model, image or clip, per second, or per 1,000 characters. It is the provider's list price. No markup on assets. A failed job costs nothing. The defaults:

| I need | Model id | Runs | Price |
| - | - | - | - |
| Textured GLB models from a prompt or a picture | `3d/default` | [Hunyuan 3D Pro](https://docs.summerengine.com/api/models/3d/hunyuan-3d.md) | \$0.525 per model |
| Concept art, sprites, textures, icons and key art | `image/default` | [Nano Banana 2 Lite](https://docs.summerengine.com/api/models/image/nano-banana-2.md) | \$0.042 per image |
| Trailer shots, cutscenes and animated key art, from a prompt or a picture | `video/default` | [Kling 3.0 Standard](https://docs.summerengine.com/api/models/video/kling-3.md) | \$0.14 per second |
| Character lines and narration from text | `voice/default` | [Expressive v3](https://docs.summerengine.com/api/models/voice/expressive-v3.md) | \$0.08 per 1,000 characters |
| Several characters talking, in one file | `dialogue/default` | [Expressive v3](https://docs.summerengine.com/api/models/dialogue/expressive-v3.md) | \$0.08 per 1,000 characters |
| Hits, footsteps, pickups, UI clicks and loops from a description | `sound/default` | [Sound Effects v2](https://docs.summerengine.com/api/models/sound/sfx-v2.md) | \$0.002 per second |
| Level, menu and combat music from a description | `music/default` | [Music v2](https://docs.summerengine.com/api/models/music/music-v2.md) | \$0.0025 per second |
| Animations for a rigged character: a move from words, or clips from a curated library | `motion/default` | [Meshy animation library](https://docs.summerengine.com/api/models/motion/library.md) | \$0.12 per animation |

Every other model and its price: [models and pricing](https://docs.summerengine.com/api/models.md). Prices checked up to 2026-10-24.

* **Priced before it spends.** The agent reads prices from `summer api models` and prices each job for free with `summer api estimate` ([`POST /v1/estimate`](https://docs.summerengine.com/api/jobs#know-the-price-first)). Ask it for the total before a big batch.
* **Paid from your Summer credits.** Jobs use your paid credits: your plan's credits and your [top-ups](https://summerengine.com/studio/credits). No plan is needed to start.
* **A limit per agent.** You pick a spend limit when you choose **Allow**. Change it or revoke the agent any time in [Settings > Connected apps](https://summerengine.com/settings/connected-apps). See [sign-in and limits](https://docs.summerengine.com/api/sign-in.md).

## Next

* [Models and pricing](https://docs.summerengine.com/api/models.md): every model with examples and its price.
* [Jobs](https://docs.summerengine.com/api/jobs.md): queued, running and done, batches and webhooks.
* [Errors](https://docs.summerengine.com/api/errors.md): `no_credits`, `over_limit` and what to show the person.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.