{"openapi":"3.1.0","info":{"title":"Kryptonite API","version":"1.0.0","summary":"Meme sounds, SFX and reactions for AI video-editing agents.","description":"Search and download sounds for video edits. Same catalog and quotas as the MCP server at https://kryptonite.gg/api/mcp/mcp.\n\n**Limits** (fair use, counted per API/MCP call; file URLs themselves are public): anonymous 5 searches + 5 downloads/day per IP; with an API key 1000 + 300/day. Create a key at https://kryptonite.gg/dashboard.\n\n**Licences**: every sound carries `license`, `commercial_use` and `legal_note`. `unverified` = rights belong to their owners, personal non-commercial use only.","contact":{"email":"hello@kryptonite.gg","url":"https://kryptonite.gg/agents"}},"servers":[{"url":"https://kryptonite.gg/api/v1"}],"security":[{},{"bearer":[]},{"apiKey":[]}],"paths":{"/sounds":{"get":{"operationId":"searchSounds","summary":"Search sounds (costs 1 search)","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":200},"description":"Keywords (AND-ed; falls back to any-word)."},{"name":"category","in":"query","schema":{"type":"string","enum":["memes","reactions","ui","impacts","comedy","anime","games","sfx","tiktok","transitions","ambient","viral"]}},{"name":"license","in":"query","schema":{"type":"string","enum":["any","cc0","commercial"],"default":"any"}},{"name":"max_duration_ms","in":"query","schema":{"type":"integer","minimum":100}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":25,"default":10}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Search results.","headers":{"X-RateLimit-Limit":{"description":"Daily limit for this kind (search or download).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining units today.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (s) of the next reset, 00:00 UTC.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}},"400":{"description":"Invalid parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily quota exceeded. Anonymous callers should sign up and use an API key.","headers":{"X-RateLimit-Limit":{"description":"Daily limit for this kind (search or download).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining units today.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (s) of the next reset, 00:00 UTC.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds until reset.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sounds/{id}":{"get":{"operationId":"getSound","summary":"Sound metadata + licence (free)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Sound id, e.g. `vine-boom`."}],"responses":{"200":{"description":"Sound.","content":{"application/json":{"schema":{"type":"object","properties":{"sound":{"$ref":"#/components/schemas/Sound"},"legal_note":{"type":"string"}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sounds/{id}/download":{"get":{"operationId":"downloadSound","summary":"Download the MP3 (costs 1 download)","description":"Default: `302` redirect to the MP3 (use `curl -L`). `format=json` returns the URL, filename, licence and attribution text; `format=base64` also inlines the bytes (≤ 1.5 MB).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Sound id, e.g. `vine-boom`."},{"name":"format","in":"query","schema":{"type":"string","enum":["redirect","json","base64"],"default":"redirect"}}],"responses":{"200":{"description":"Download info.","headers":{"X-RateLimit-Limit":{"description":"Daily limit for this kind (search or download).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining units today.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (s) of the next reset, 00:00 UTC.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Download"}}}},"302":{"description":"Redirect to the audio file.","headers":{"X-RateLimit-Limit":{"description":"Daily limit for this kind (search or download).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining units today.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (s) of the next reset, 00:00 UTC.","schema":{"type":"integer"}},"Location":{"schema":{"type":"string","format":"uri"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Too large for base64.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Daily quota exceeded. Anonymous callers should sign up and use an API key.","headers":{"X-RateLimit-Limit":{"description":"Daily limit for this kind (search or download).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining units today.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (s) of the next reset, 00:00 UTC.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds until reset.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/categories":{"get":{"operationId":"listCategories","summary":"Categories with counts + licence types (free)","responses":{"200":{"description":"Categories.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/quota":{"get":{"operationId":"getQuota","summary":"Remaining quota for the caller (free)","responses":{"200":{"description":"Quota.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quota"}}}},"401":{"description":"Invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"API key `kr_live_…` from /dashboard."},"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"signup_url":{"type":"string"},"retry_after_seconds":{"type":"integer"}}}}},"Sound":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":["string","null"],"description":"What the sound is, concretely."},"when_to_use":{"type":["string","null"],"description":"Placement guidance for editors and agents: when the sound fits and when to avoid it."},"description_source":{"type":["string","null"],"enum":["uploader","editorial","ai",null],"description":"Who wrote description/when_to_use. `ai` = written by a model that listened to the audio."},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"duration_ms":{"type":"integer"},"size_bytes":{"type":"integer"},"format":{"type":"string","const":"audio/mpeg"},"origin":{"type":"string"},"license":{"type":"string","enum":["cc0","cc-by","own-work","unverified"]},"license_label":{"type":"string"},"commercial_use":{"type":"boolean"},"attribution":{"type":["string","null"]},"legal_note":{"type":"string"},"page_url":{"type":"string","format":"uri"},"preview_url":{"type":"string","format":"uri"},"stats":{"type":"object","properties":{"views":{"type":"integer"},"downloads":{"type":"integer"},"likes":{"type":"integer"}},"description":"Popularity signals (page views, downloads, likes)."},"mcp_uri":{"type":"string"},"download_endpoint":{"type":"string","format":"uri"},"credits_line":{"type":"string"}}},"QuotaCounter":{"type":"object","properties":{"kind":{"type":"string"},"used":{"type":"integer"},"limit":{"type":"integer"},"remaining":{"type":"integer"},"tier":{"type":"string"},"reset_at":{"type":"string","format":"date-time"}}},"SearchResult":{"type":"object","properties":{"query":{"type":"string"},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_offset":{"type":["integer","null"]},"matched":{"type":"string","enum":["all_terms","any_term"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/Sound"}},"quota":{"$ref":"#/components/schemas/QuotaCounter"},"legal_note":{"type":"string"}}},"Download":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"filename":{"type":"string"},"mime_type":{"type":"string"},"size_bytes":{"type":"integer"},"duration_ms":{"type":"integer"},"base64":{"type":"string"},"license":{"type":"string"},"commercial_use":{"type":"boolean"},"attribution_text":{"type":"string"},"legal_note":{"type":"string"},"quota":{"$ref":"#/components/schemas/QuotaCounter"}}},"Quota":{"type":"object","properties":{"tier":{"type":"string","enum":["anonymous","authenticated"]},"searches":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":"integer"},"remaining":{"type":"integer"}}},"downloads":{"type":"object","properties":{"used":{"type":"integer"},"limit":{"type":"integer"},"remaining":{"type":"integer"}}},"reset_at":{"type":"string","format":"date-time"},"how_to_raise_limits":{"type":"string"}}}}}}