Skip to content
Documentation menu
docs / api / get-v1-voice-clips-clip
Voice

GET/v1/voice/clips/{clip}

Access and price

AuthAn 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.
PriceNot 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

NameInTypeRequiredDescription
clippathstringyes<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