GET/v1/voice/bank

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

Call it

bash

curl -fsS -X GET "https://api.mapmap.ai/v1/voice/bank?format=…" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Name	In	Required	Description
voice	query	no	Registry voice id to list (`en-gb-f`, `amelia`, `fr-fr-1`). Absent is the en-GB default (`en-gb-f`; it was `amelia` until 5 Oct 2026), so a bundler of Amelia's clips names her.
format	query	yes	Container: `opus` or `m4a`.
limit	query	no	Page size, 1–1000 (default 1000).
after	query	no	Resume after this hash: the `next_after` of the previous page.

200Cached clips for one voice and format, paged by hash

Field	Type	Required	Description
clips	BankClip[]	yes	Clips cached for this voice and format, ordered by hash.
format	string	yes	The container these clips are in.
next_after	string	no	Pass as `after` for the next page; absent on the last page.
total	integer	yes	Clips cached in total for this voice and format, across all pages.
voice	VoiceDescriptor	yes	The voice, provider and model these clips were rendered with.

400Invalid query, or unknown_voice

401Missing or invalid API key

403Not an operator key: the bank listing is for build-time bundling by the operator

501Voice clips are not enabled

Error bodies follow the shared problem model documented on API conventions.

Generated from https://api.mapmap.ai/openapi.json on 2026-11-02 · operationId get_bank