Documentation menu
Voice
GET/v1/voice/clips/{clip}
Access and price
| Auth | An API key, as Authorization: Bearer snk_… or ?api_key=snk_…. Not metered: it draws no quota and no credit. Needs a full key; a browser (maps) key is refused. |
|---|---|
| Price | Not metered: no quota, no credit. |
What it does
Serve one cached clip.
An API key, as Authorization: Bearer snk_… or ?api_key=snk_…. Not metered: it draws no quota and no credit.
Call it
bash
curl -fsS -X GET "https://api.mapmap.ai/v1/voice/clips/{clip}" \
-H "Authorization: Bearer $MAPMAP_KEY"Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| clip | path | string | yes | <hash>.<ext>, exactly as returned by POST /v1/voice/clips |
Responses
200The clip audio (audio/ogg or audio/mp4), immutable for a year
401Missing or invalid API key. Also: No key, or a missing, malformed, unknown, revoked or expired one (
unauthorized)application/problem+json · Problem
403A browser (
maps-scoped) key on a route that needs a full-scope key (scope-insufficient)application/problem+json · Problem
404No such clip in this deployment's cache
application/problem+json · Problem
429Rate limit exceeded
application/problem+json · Problem
501Voice clips are not enabled
application/problem+json · Problem
504The request did not finish within the gateway's request deadline (
request-timeout)application/problem+json · Problem
Error bodies follow the shared problem model documented on API conventions.
Also under Voice
Generated from https://api.mapmap.ai/openapi.json on 2026-11-12 · operationId get_clip