Documentation menu
voice
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"Parameters
| Name | In | Required | Description |
|---|---|---|---|
| voice | query | no | Voice id; only amelia today. |
| 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. |
Responses
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
401Missing or invalid API key
501Voice clips are not enabled
Error bodies follow the shared problem model documented on API conventions.
Also under voice
Generated from https://api.mapmap.ai/openapi.json on 2026-09-18 · operationId get_bank