> ## 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: game assets for any agent

> One API for game assets: 3D models, images, video, voice, sound effects and music from curated models tested for games. One sign-in, game-ready files in your Summer library. No markup on assets. Every model at the provider's list price.

Summer is the game engine built for AI. With the **Summer API**, your agent signs in once, sends one call and gets back a file your game can load: a GLB, a PNG or an audio file, saved to your Summer library.

> [!NOTE]
>
> **No markup on assets. Every model at the provider's list price.** Each price is on the [models page](https://docs.summerengine.com/api/models.md). A failed job costs nothing.

![A stylized wooden treasure chest with gold trim, made by a Summer 3D model](https://mintcdn.com/summer-18f03259/vhHCDCU3lQOLrG8N/images/api/chest.png?fit=max\&auto=format\&n=vhHCDCU3lQOLrG8N\&q=85\&s=28df6e23af52ed1a33446af4b98f59fd)

From the prompt "a stylized treasure chest, game prop": a textured GLB

![A frost golem character in armour with glowing blue crystals, made by a Summer 3D model](https://mintcdn.com/summer-18f03259/vhHCDCU3lQOLrG8N/images/api/golem.png?fit=max\&auto=format\&n=vhHCDCU3lQOLrG8N\&q=85\&s=fdeedd5d962889f0ce524242b63a4804)

From a one-paragraph prompt: a frost golem hero as a textured GLB

## Set up with your agent

Paste this into Claude Code, Codex, Cursor, Hermes or any agent that can run commands. You sign in once and choose Allow with a spend limit, and the agent makes its first asset.

```text Prompt for your agent wrap theme={null}
Use the Summer API for game assets (docs: https://docs.summerengine.com/llms.txt). Run `npx -y summer-engine@latest login` so I can sign in. Then run `npx -y summer-engine@latest api run 3d/default --input '{"kind":"text-to-3d","prompt":"a stylized treasure chest, game prop"}' --download assets` and tell me where the GLB is.
```

In ChatGPT or Claude, add `https://mcp.summerengine.com/mcp` as a connector instead. See [Agents](https://docs.summerengine.com/api/agents.md).

## What you can make

> **[3D models](https://docs.summerengine.com/api/models.md#3d-models)**
>
> Props, characters and buildings as textured GLB files, from text or a picture. Add a rig and animations on the same job.

> **[Images](https://docs.summerengine.com/api/models.md#images)**
>
> Concept art, sprites, textures, icons and key art, with an optional transparent background.

> **[Video](https://docs.summerengine.com/api/models.md#video)**
>
> Trailer shots, cutscenes and animated key art, from text or a picture.

> **[Voice and dialogue](https://docs.summerengine.com/api/models.md#voice)**
>
> Character lines, narration and conversations between several characters.

> **[Sound effects](https://docs.summerengine.com/api/models.md#sound-effects)**
>
> Hits, footsteps, pickups, UI clicks and seamless loops.

> **[Music](https://docs.summerengine.com/api/models.md#music)**
>
> Level, menu and combat music from a description.

Browse every model with examples and prices: [summerengine.com/models](https://www.summerengine.com/models).

## How to make it

Step-by-step guides that chain the right models for one real job, with the exact CLI, API and MCP steps and what the whole chain costs. Hand one to your agent and it runs it.

> **[A 3D character](https://docs.summerengine.com/api/guides/3d-character.md)**
>
> Concept, model, rig and animations.

> **[Cutscenes](https://docs.summerengine.com/api/guides/cutscenes.md)**
>
> Shots that keep your character on-model.

> **[A game trailer](https://docs.summerengine.com/api/guides/trailer.md)**
>
> Real gameplay, a hook shot, music and store cuts.

> **[Sound effects](https://docs.summerengine.com/api/guides/sound-effects.md)**
>
> A full pack in one batch.

> **[Cutscene music](https://docs.summerengine.com/api/guides/cutscene-music.md)**
>
> Cues timed to the scene.

> **[Every guide](https://docs.summerengine.com/api/guides.md)**
>
> Voice lines, logos, textures, props, icons, title screens.

## One call

```bash theme={null}
curl https://www.summerengine.com/v1/jobs \
  -H "Authorization: Bearer $SUMMER_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Prefer: wait=60" \
  -d '{"model": "image/default", "input": {"prompt": "a cozy pixel-art tavern at night"}}'
```

Images, voice and sound come back in the same call. A 3D model takes a few minutes: the call answers with a job id, and your agent follows it until the file is ready. With the CLI it is one command: `summer api run 3d/default --input '...' --download`. The [quickstart](https://docs.summerengine.com/api/quickstart.md) makes a 3D model end to end.

## Why Summer

* **Curated and tested for games.** A short list of the best model for each job, not hundreds. Each default id, such as `3d/default`, runs the model Summer tests first and moves when a better one passes.
* **Game-ready output.** 3D models come back as GLB files with textures, and with a rig and animations when you ask. Images can come back with a transparent background. Sound effects can loop.
* **Files you keep.** Every result is saved to your Summer library, private to you, with a Summer URL and an asset id. In Summer Engine, your agent imports it by id.
* **The price before you spend.** `POST /v1/estimate` gives the exact price of a request and a quote that holds it for 15 minutes. It is free and needs no sign-in.
* **Safe for agents.** No API keys to leak. Each agent you connect has its own spend limit, and you can revoke it at any time. Retries with the same `Idempotency-Key` never charge twice.
* **One balance.** Every model draws from your paid Summer credits: your plan's credits or your top-ups. Top-ups alone are enough.

## Works with every agent

| How | For | Start |
| - | - | - |
| `summer` CLI | Coding agents in a terminal: Claude Code, Codex, Cursor, Hermes | [Agents](https://docs.summerengine.com/api/agents.md#the-summer-cli) |
| REST with a bearer token | Any agent or program: `summer token`, or your own OAuth sign-in | [Sign-in](https://docs.summerengine.com/api/sign-in.md) |
| MCP | ChatGPT, Claude and other chat apps | [Agents](https://docs.summerengine.com/api/agents.md#chatgpt-and-claude) |
| OpenAPI 3.1 | SDK generators and tools | [`/v1/openapi.json`](https://www.summerengine.com/v1/openapi.json) |

> **[Quickstart](https://docs.summerengine.com/api/quickstart.md)**
>
> Sign in, check the price, make a 3D model and save the GLB. curl, TypeScript and Python.

> **[Models and pricing](https://docs.summerengine.com/api/models.md)**
>
> Every model with its price, typical time and output format.


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