Soundza

npx add-mcp 'https://mcp.soundza.com/mcp/oauth'

कैसे कनेक्ट करें

soundza का उपयोग किसी AI असिस्टेंट से या अपने खुद के कोड से करें। दोनों मुफ्त हैं और समान ध्वनियाँ प्राप्त करते हैं।

AI असिस्टेंट में

Claude, ChatGPT, Claude Code या किसी भी MCP ऐप में, soundza MCP सर्वर जोड़ें और एक बार मुफ्त खाते से साइन इन करें। प्रत्येक के चरण नीचे दिए गए हैं।

अपने खुद के कोड में

ऐप्स, गेम्स, स्क्रिप्ट्स और बिल्ड टूल्स में, मुफ्त API कुंजी के साथ REST API को कॉल करें। कुंजी प्राप्त करें।

REST

https://api.soundza.com/v1

MCP, साइन-इन

https://mcp.soundza.com/mcp/oauth

MCP, API कुंजी

https://mcp.soundza.com/mcp

OpenAPI

soundza.com/openapi.json

एजेंट्स के लिए

soundza.com/llms.txt

MCP सर्वर में पाँच टूल हैं: search_sounds, get_sound, search_packs, get_pack और download_sound, जो 15-मिनट का लिंक, एक तैयार curl कमांड और ध्वनि का पृष्ठ लौटाता है।

Claude

1. Add to Claude पर क्लिक करें। Claude नाम और URL भरकर खुलता है। Add पर क्लिक करें।
2. soundza में साइन इन करें और अनुमोदन करें। एक मुफ्त खाता ही पर्याप्त है।
3. चैट में, + पर क्लिक करें, Connectors खोलें और Soundza चालू करें।

Add to Claude या https://mcp.soundza.com/mcp/oauth के साथ एक कस्टम कनेक्टर जोड़ें

ChatGPT

1. ChatGPT plugins खोलें और एक कस्टम MCP सर्वर जोड़ें। इसे Soundza नाम दें और OAuth रखें।
2. नीचे URL पेस्ट करें, फिर soundza में साइन इन करें।
3. नई चैट में, टूल्स मेनू से Soundza चुनें।

URL https://mcp.soundza.com/mcp/oauth

कस्टम सर्वर आपकी ChatGPT योजना पर निर्भर करते हैं; कुछ को सेटिंग्स में Developer mode चालू करने की आवश्यकता होती है।

Claude Code

इसे जोड़ें, फिर /mcp चलाएँ, soundza चुनें और ब्राउज़र में साइन इन करें।

claude mcp add --transport http soundza https://mcp.soundza.com/mcp/oauth

कुंजी का उपयोग करना चाहते हैं? SOUNDZA_API_KEY सेट करें और Authorization हेडर के साथ https://mcp.soundza.com/mcp जोड़ें। कुंजी पृष्ठ यह कमांड आपकी कुंजी भरकर दिखाता है:

claude mcp add --transport http soundza https://mcp.soundza.com/mcp --header "Authorization: Bearer $SOUNDZA_API_KEY"

Codex, Cursor और अन्य एजेंट्स

कोई भी क्लाइंट जो streamable HTTP बोलता है। यदि यह साइन-इन का समर्थन करता है तो https://mcp.soundza.com/mcp/oauth का उपयोग करें, अन्यथा Authorization हेडर के साथ https://mcp.soundza.com/mcp का उपयोग करें। Cursor के लिए, इसे ~/.cursor/mcp.json में जोड़ें; यह कुंजी आपके वातावरण से पढ़ता है, इसलिए कुंजी उन फ़ाइलों से बाहर रहती है जिन्हें आप कमिट कर सकते हैं।

{
  "mcpServers": {
    "soundza": {
      "url": "https://mcp.soundza.com/mcp",
      "headers": { "Authorization": "Bearer ${env:SOUNDZA_API_KEY}" }
    }
  }
}

API कुंजी प्राप्त करें

अपने खुद के कोड में कुंजी का उपयोग करें। इसे Authorization: Bearer <key> के रूप में भेजें। कुंजियाँ sz_live_ से शुरू होती हैं। अपनी कुंजी को अपने सर्वर पर या gitignored .env में रखें, कभी भी क्लाइंट कोड में नहीं।

इसे स्वयं बनाएँ

कुंजी पृष्ठ पर साइन इन करें और कुंजी बनाएँ। यह केवल एक बार दिखाई जाती है, MCP कमांड भरकर।

या अपने एजेंट को साइन इन करने दें

अपने कोडिंग एजेंट से soundza.com पर ध्वनियाँ खोजने के लिए कहें। यह llms.txt पढ़ता है, आपको अनुमोदन के लिए एक लिंक भेजता है, और कुंजी स्वयं सहेजता है।

Soundza is free, but every call needs an API key tied to a person's account. Get one with a one-click sign-in:

1. Start the sign-in. Include what the person is building, if you know it from the project: project_kind (one of game, video_tool, own_content, app, agent, music, trying, other) and project, one plain line about it. After approving, the person sees both and can change them; leave out anything you'd have to guess.
   curl -s -X POST https://api.soundza.com/v1/auth/device -H "content-type: application/json" -d '{"client_name":"<your tool> on <this machine>","project_kind":"game","project":"<one line, e.g. A retro sci-fi shooter in Godot>"}'
   It returns device_code, user_code, verification_uri_complete, expires_in (600 seconds) and interval (5 seconds).
2. Tell the human: "Open <verification_uri_complete> and approve code <user_code> (sign in with Google if it asks)." Nothing else is needed from them.
3. Right after telling them, poll every <interval> seconds until they approve. Run the polling loop in the foreground and wait for it; don't end your turn while the sign-in is pending (the code lasts 10 minutes).
   curl -s -X POST https://api.soundza.com/v1/auth/token -H "content-type: application/json" -d '{"device_code":"<device_code>"}'
   While it returns {"error":"authorization_pending"} keep polling; on "slow_down" wait the "interval" it returns. On approval it returns {"access_token":"sz_live_...","token_type":"Bearer",...} once: access_token is the API key. "expired_token" or "access_denied" means stop (start again only if the human asks).
4. Save the key as SOUNDZA_API_KEY in the project's .env and make sure .env is in .gitignore. Never commit the key or put it in a project-scope .mcp.json.
5. Optional: connect this MCP server with the key. The command reads $SOUNDZA_API_KEY from the shell, so load .env first (set -a; . ./.env; set +a). It stores the key in Claude Code's own settings (local scope), not in the project. If soundza is already added without a key, run "claude mcp remove soundza" first.
   claude mcp add --transport http soundza https://mcp.soundza.com/mcp --header "Authorization: Bearer $SOUNDZA_API_KEY"
   The tools load in the next session (or after /mcp). Until then, and in any tool that can't add MCP servers, use the REST API at https://api.soundza.com/v1 with the header "Authorization: Bearer $SOUNDZA_API_KEY". It does everything the MCP tools do.

A person can also create a key at https://soundza.com/developers/keys and set it the same way.

त्वरित आरंभ

खोजें, फिर जो उपयोग करें उसे डाउनलोड करें। पहले SOUNDZA_API_KEY सेट करें।

curl -s "https://api.soundza.com/v1/sounds/search?type=sound_effect&q=whoosh&per_page=5" \
  -H "Authorization: Bearer $SOUNDZA_API_KEY"

# download_url redirects to the file: -L follows it, -OJ saves it under its own name
curl -LOJ "https://api.soundza.com/v1/sounds/SOUND_ID/file" \
  -H "Authorization: Bearer $SOUNDZA_API_KEY"

प्रत्येक परिणाम में preview_files, 128 kbps MP3s हैं जो हमारे CDN से बिना कुंजी के सीधे चलते हैं, और पूर्ण-गुणवत्ता फ़ाइल के लिए एक download_url है।

एंडपॉइंट्स

हर एंडपॉइंट https://api.soundza.com/v1 के अंतर्गत एक GET अनुरोध है। पूर्ण विनिर्देश /openapi.json पर है।

एंडपॉइंट	यह क्या करता है
GET /sounds/search	शब्दों और फ़िल्टर द्वारा खोजें। ध्वनियों का एक पृष्ठ और search_id लौटाता है।
GET /sounds/{id}	एक ध्वनि, id द्वारा।
GET /sounds/{id}/file	पूर्ण-गुणवत्ता फ़ाइल, आमतौर पर WAV, कैटलॉग से स्तर-मिलान;?variant=original मूल अपरिवर्तित के लिए। एक लिंक के लिए 302 जो 5 मिनट के लिए काम करता है। वैकल्पिक search_id और user।
GET /packs	सार्वजनिक पैक, सर्वश्रेष्ठ पहले। वैकल्पिक q, page और per_page।
GET /packs/{id}	एक पैक, फिर उसकी ध्वनियों का एक पृष्ठ। हर ध्वनि अपने पैक का नाम बताती है।
GET /removals?since=	एक ISO तिथि के बाद से हटाई गई ध्वनियाँ, फ़ाइलें संग्रहीत करने वालों के लिए।

खोज पैरामीटर

एक q, कम से कम एक फ़िल्टर, या दोनों दें। अवधियाँ सेकंड में हैं।

पैरामीटर	प्रकार	विवरण
q	string	मिलान करने के लिए शब्द, जैसे "door slam" या "lofi drum loop"। टाइपो माफ़ हैं।
type	string	ध्वनि क्या है: music, sound_effect या ambience (Type and facts देखें)। केस-असंवेदनशील। q के साथ खोज जो अपने प्रकार के भीतर कुछ नहीं पाती है, हर प्रकार खोजती है, और relaxed_filters में ऐसा कहती है।
form	string	केवल संगीत: track, excerpt, loop, one_shot या stem।
parts	string	केवल संगीत: full_mix या single_part। इसके बिना, type=music पहले full mixes, फिर loops, फिर single parts रैंक करता है।
vocals	string	केवल संगीत: none, backing या lead।
style	string	केवल ध्वनि प्रभाव: retro या cartoon। प्रति पैक सेट, इसलिए अधिकांश ध्वनियों में कोई नहीं; q के साथ जो इसके साथ कुछ नहीं पाता, इसे हटा दिया जाता है और relaxed_filters में सूचीबद्ध किया जाता है।
min_duration	number	सबसे छोटी लंबाई, सेकंड में।
max_duration	number	सबसे लंबी लंबाई, सेकंड में।
min_bpm	number	सबसे धीमी गति। केवल संगीत में गति होती है।
max_bpm	number	सबसे तेज़ गति।
key	string	संगीत कुंजी, जैसे "C", "F# minor" या "Bbm"। केवल उन कुंजियों से मेल खाता है जो ध्वनियाँ दिखाती हैं: स्रोत या व्यक्ति द्वारा बताई गई, या उच्च आत्मविश्वास के साथ पहचानी गई।
chord	string	कॉर्ड जो एक chord one-shot बजाता है, जैसे "Am", "C#m7" या "Fmaj7"।
note	string	नोट जो एक pitched one-shot बजाता है: उस सप्तक के लिए "D3" (C3 मध्य C है), या किसी भी सप्तक के लिए "D"।
mood	list	अल्पविराम-पृथक मूड शब्द; उनमें से किसी से मेल खाने वाली ध्वनियाँ वापस आती हैं, और अधिक मेल उच्च रैंक करते हैं। इनमें से एक: airy, heavy, metallic, bright, dark, punchy, soft, warm, glitchy, organic, cinematic, cartoony, retro।
good_for	list	अल्पविराम-पृथक कार्य जिनके लिए ध्वनि उपयुक्त होनी चाहिए। केवल रैंकिंग: मेल खाने वाली ध्वनियाँ उच्च रैंक करती हैं, और कुछ भी फ़िल्टर नहीं किया जाता। इनमें से एक: transition, reveal, build_up, impact_on_beat, title_or_logo, notification, ui_click, menu, game_pickup, game_hit, game_power_up, footsteps, background_bed, intro, outro।
fit_seconds	number	वह लंबाई जिसे ध्वनि को भरना है, जैसे 20-सेकंड विज्ञापन के लिए 20। उन ध्वनियों को रैंक करता है जो इसे भर सकती हैं (कम से कम उतनी लंबी ट्रैक, या एक निर्बाध लूप) और प्रत्येक परिणाम में एक fit संकेत जोड़ता है। यह कुछ भी फ़िल्टर नहीं करता।
pack	string	एक पैक का id या slug: केवल उस पैक की ध्वनियाँ।
loop_seamless	boolean	true: केवल वे ध्वनियाँ जो निर्बाध रूप से लूप करती हैं, जैसा कि ऑडियो से मापा गया है (अंत बिना क्लिक या कूद के शुरुआत में वापस चलता है)। गेम संगीत और ambience beds के लिए जो एक दृश्य के तहत दोहराते हैं।
category	string	एक Universal Category System शीर्ष-स्तरीय श्रेणी ("CROWDS") या CatID ("CRWDCheer")। ध्वनि प्रभाव और ambience।
page	integer	पृष्ठ संख्या, 1 से।
per_page	integer	प्रति पृष्ठ परिणाम: डिफ़ॉल्ट 15, अधिकतम 50। परिणाम प्रति क्वेरी 500 पर रुकते हैं।

प्रतिक्रिया

परिणामों का एक पृष्ठ, अगले पृष्ठ के लिंक के साथ। bpm और key संगीत का वर्णन करते हैं; creator null है जब एक ध्वनि का कोई सार्वजनिक निर्माता नहीं है।

फ़ाइलें स्तर-मिलान हैं, इसलिए ध्वनियाँ प्रत्येक को समायोजित किए बिना एक साथ बैठती हैं: प्रति ध्वनि एक gain, कोई संपीड़न नहीं, चोटियाँ −1 dBTP पर या उससे नीचे। Ambience −20 LUFS का लक्ष्य रखता है, संगीत, pads और लंबे loops −16, बाकी सब कुछ इसके सबसे तेज़ 400 ms पर −13। lufs, true_peak_db और loudness मूल का वर्णन करते हैं; gain_db वह है जो डिफ़ॉल्ट फ़ाइल इसमें जोड़ती है। मूल अपलोड के रूप में फ़ाइल रूट में ?variant=original जोड़ें।

{
  "page": 1,
  "per_page": 5,
  "total_results": 38,
  "next_page": "https://api.soundza.com/v1/sounds/search?q=whoosh&type=SOUND_EFFECT&per_page=5&page=2",
  "search_id": "x7k2m9q4r1t8v3w6y0z5a2b4",
  "sounds": [
    {
      "id": "cm9w2k4e30001",
      "url": "https://soundza.com/sounds/fast-air-whoosh",
      "title": "Fast Air Whoosh",
      "description": "A quick, bright air whoosh that sweeps left to right.",
      "type": "sound_effect",
      "form": null,
      "parts": null,
      "vocals": null,
      "style": null,
      "good_for": ["transition"],
      "duration": 0.84,
      "bpm": null,
      "key": null,
      "chord": null,
      "note": null,
      "mood": ["airy", "bright"],
      "tags": ["whoosh", "swipe", "air", "airy", "bright"],
      "sync_ms": 310,
      "lufs": -19.4,
      "true_peak_db": -6.1,
      "loudness": { "value": -18.2, "basis": "momentary_max" },
      "gain_db": 5.1,
      "loop_seamless": null,
      "file_type": "audio/wav",
      "file_extension": "wav",
      "sample_rate": 48000,
      "bit_depth": 24,
      "channels": 2,
      "size_bytes": 322604,
      "category": { "id": "WHSH", "label": "Swooshes › Whoosh" },
      "pack": {
        "id": "cm8p1x7a20004",
        "name": "Air and Motion",
        "slug": "air-and-motion",
        "sound_count": 42,
        "url": "https://soundza.com/packs/air-and-motion"
      },
      "creator": null,
      "preview_files": [
        { "type": "audio/mpeg", "bitrate": 128, "link": "https://media.soundza.com/public/previews/4fJ9aQx2LmP0sT7vKc1Rb8Ze.mp3" }
      ],
      "download_url": "https://api.soundza.com/v1/sounds/cm9w2k4e30001/file",
      "license": { "name": "Soundza Standard License", "url": "https://soundza.com/license" },
      "attribution": "\"Fast Air Whoosh\" on Soundza (https://soundza.com/sounds/fast-air-whoosh)"
    }
  ]
}

प्रकार और तथ्य

type बताता है कि ध्वनि क्या है। पहले प्रकार से फ़िल्टर करें, फिर उन तथ्यों से जो आप जानते हैं, फिर बाकी को q में डालें।

type	क्या शामिल है	तथ्य
music	ट्रैक, अंश, लूप, one-shots, stems, stingers, jingles और vocal chops, गेम संगीत सहित।	form (track, excerpt, loop, one_shot, stem), parts (full_mix, single_part), vocals (none, backing, lead), bpm, key, note, chord
sound_effect	Whooshes, impacts, foley, UI और गेम ध्वनियाँ, प्रभाव के रूप में आवाज़ें।	category (UCS), style (retro, cartoon; प्रति पैक सेट)
ambience	स्थान, कमरे की टोन और शोर बेड।	category (UCS)

"कॉर्पोरेट पृष्ठभूमि संगीत, बिना स्वर" type=music&vocals=none&q=corporate है। type=music के साथ, full mixes पहले आते हैं, फिर loops, फिर single parts, जब तक आप parts सेट नहीं करते। good_for एक कार्य के लिए उपयुक्त ध्वनियों (transition, ui_click, background_bed …) को परिणामों में ऊपर ले जाता है बिना किसी को फ़िल्टर किए। q के साथ खोज जो अपने प्रकार के भीतर कुछ नहीं पाती है, हर प्रकार खोजती है और relaxed_filters में type सूचीबद्ध करती है।

सीमाएँ

मुफ्त कुंजियाँ प्राप्त करती हैं:

• 60 खोजें प्रति मिनट
• 250 डाउनलोड प्रति घंटा
• 350 डाउनलोड प्रति दिन

हर प्रतिक्रिया में ये हेडर शामिल हैं। एक 429 में Retry-After भी शामिल है, सेकंड में:

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset
• X-RateLimit-Policy

एक खाते की सभी कुंजियाँ इन सीमाओं को साझा करती हैं। ध्वनियों को उनके preview_files के साथ सुनें, जो मुफ्त हैं और गिनती नहीं करते, और केवल उन ध्वनियों को डाउनलोड करें जिनका आप उपयोग करते हैं।

केवल अलग-अलग ध्वनियाँ डाउनलोड के रूप में गिनती हैं, इसलिए 24 घंटों के भीतर एक ही ध्वनि को फिर से लाना मुफ्त है। कुल फ़ाइल लाने की सीमा डाउनलोड सीमाओं से दोगुनी है। प्रत्येक फ़ाइल को एक बार सहेजें और ध्वनि के id द्वारा पुनः उपयोग करें। एकल ध्वनि या पैक देखने की अलग सीमा है, खोज सीमा से पाँच गुना।

अपने ऐप में ध्वनि चयनकर्ता लगा रहे हैं? आगे बढ़ें: एक मुफ्त कुंजी एक छोटे ऐप को कवर करती है जिसमें प्रतिदिन कुछ उपयोगकर्ता होते हैं। एक बार जब इसे वास्तविक ट्रैफ़िक मिलता है, तो कुंजी पृष्ठ से उच्च सीमाएँ अनुरोध करें और हमें इसके बारे में थोड़ा बताएं, या admin@soundza.com पर लिखें। हम ईमेल द्वारा उत्तर देंगे।

उच्च सीमाएँ अनुरोध करें

श्रेय देना

सब कुछ पूरी तरह से मुफ्त है। केवल एक चीज जो हम पूछते हैं वह है soundza.com (और/या एक मूल ध्वनि निर्माता यदि लागू हो) को क्रेडिट देना जहाँ यह आपके प्रोजेक्ट के लिए समझ में आता है। आदर्श रूप से कृपया अपनी वेबसाइट/ब्लॉग/itch पृष्ठ पर कहीं soundza.com का लिंक शामिल करें (जैसे 'Thanks to soundza.com for the free sounds')। यदि आपके पास साइट नहीं है, तो हमें सोशल मीडिया या YouTube वीडियो विवरण आदि में शाउटआउट भी पसंद आएगा। शब्द फैलाने में मदद करें!

नीचे कुछ उदाहरण हैं। हम इस बात में लचीले हैं कि आप हमें कैसे क्रेडिट करते हैं, लेकिन हम पूछते हैं कि कृपया इसे किसी ऐसे तरीके से करें जो आपके प्रोजेक्ट के लिए स्वाभाविक रूप से काम करे।

आप क्या बना रहे हैं	कैसे क्रेडिट करें
ध्वनि चयनकर्ता वाला ऐप या टूल	चयनकर्ता में Powered by soundza, साथ ही आपकी साइट के फुटर, About पृष्ठ, ब्लॉग, या कहीं और जो समझ में आता है, soundza.com का लिंक।
एक गेम, यहाँ तक कि एक छोटा	जहाँ भी आप इसे साझा करते हैं (Reddit या Discord पोस्ट, X, आपका devlog या साइट, itch.io या Steam), soundza.com के लिए एक त्वरित धन्यवाद, जहाँ आप कर सकते हैं लिंक के साथ।
वीडियो	YouTube विवरण में Sound effects: soundza.com। TikTok या Instagram पर, यदि संभव हो तो @soundza_audio टैग करें।
एक बॉट, एजेंट या ओपन-सोर्स टूल	आपके README, सहायता पाठ या सूची पृष्ठ में एक पंक्ति।
कुछ सिर्फ आपके लिए	कुछ भी आवश्यक नहीं।

हमारा लोगो उपयोग करना चाहते हैं? आप इसे अपने लिंक के साथ दिखा सकते हैं: पूर्ण लोगो (PNG) या अकेला चिह्न (SVG)। बस इसे अपने ऐप के आइकन के रूप में उपयोग न करें।

soundza के साथ कुछ बनाया है? हम इसे देखना पसंद करेंगे। admin@soundza.com पर ईमेल करें या @soundza_audio टैग करें। हम अच्छे प्रोजेक्ट साझा करते हैं।

त्रुटियाँ

त्रुटियाँ JSON हैं: {"error": {"code", "message", "details"?}}।

स्थिति	कोड	अर्थ
400	invalid_request	एक पैरामीटर गलत है। details प्रत्येक को सूचीबद्ध करता है।
401	missing_key	कोई Authorization: Bearer हेडर नहीं।
401	invalid_key	कुंजी मौजूद नहीं है।
401	revoked_key	कुंजी रद्द कर दी गई थी।
404	not_found	उस id वाली कोई सार्वजनिक ध्वनि नहीं है।
429	rate_limited	एक सीमा हिट हुई। Retry-After सेकंड प्रतीक्षा करें।
500	server_error	हमारी ओर से कुछ गलत हो गया। थोड़ी देर में फिर से प्रयास करें।

लाइसेंसिंग

हर ध्वनि Soundza Standard License के अंतर्गत आती है, जो उसके license फ़ील्ड से जुड़ी होती है: व्यक्तिगत और व्यावसायिक कार्यों के लिए रॉयल्टी-मुक्त, और ध्वनियों के लिए कोई श्रेय आवश्यक नहीं है (बदले में हम जो माँगते हैं उसके लिए giving credit देखें)। हम ध्वनियों की सावधानीपूर्वक समीक्षा करते हैं, लेकिन उन्हें यथावत प्रदान करते हैं, बिना किसी गारंटी के कि ध्वनि तीसरे पक्ष के दावों से मुक्त है। लाइसेंस में पूरी शर्तें हैं।

दिशानिर्देश

• जब आपकी टीम के बाहर के लोग आपकी बनाई चीज़ देखें, तो soundza.com से वापस लिंक करें जैसे उपयुक्त लगे: आपके साउंड पिकर के पास "Powered by soundza" और आपकी साइट पर एक लिंक, जहाँ आप अपना गेम साझा करते हैं वहाँ एक धन्यवाद, या आपके वीडियो विवरण में एक पंक्ति। soundza.com/developers#credit देखें।
• किसी ध्वनि का download_url तब माँगें जब उसे किसी प्रोजेक्ट में जोड़ा जाए, फ़ाइल को एक बार सहेजें, और ध्वनि के id द्वारा उसका पुनः उपयोग करें।
• पूर्वावलोकन सुनने के लिए हैं। तैयार कार्यों में डाउनलोड की गई फ़ाइलों का उपयोग करें।
• Soundza की मुख्य कार्यक्षमता की नकल न करें या प्रतिस्पर्धी साउंड लाइब्रेरी या API न बनाएँ।
• एक मुफ्त कुंजी 500 तक डाउनलोड की गई ध्वनियाँ संग्रहीत कर सकती है। GET /v1/removals में सूचीबद्ध किसी भी ध्वनि को हटाएँ, और इसे कम से कम मासिक रूप से जाँचें।
• दर सीमाओं का सम्मान करें, और जब आपको अधिक चाहिए तो पूछें। हम किसी भी समय, किसी भी कारण से, किसी के लिए भी API पहुँच निलंबित या समाप्त कर सकते हैं।

API का उपयोग Terms of Service और License द्वारा शासित है।

Soundza पिकर

आपके उत्पाद के लिए एक साउंड पिकर तीन फ़ाइलों में: दो सर्वर रूट जो आपकी कुंजी को निजी रखते हैं, और एक घटक जिसमें चिप्स, पूर्वावलोकन और क्रेडिट लिंक शामिल हैं। इसे अपने ऐप से मेल खाने के लिए स्टाइल करें।

// app/api/sounds/route.ts: search, with your key kept on the server
export async function GET(req: Request) {
  const params = new URL(req.url).searchParams;
  const res = await fetch(\`https://api.soundza.com/v1/sounds/search?${params}\`, {
    headers: { Authorization: \`Bearer ${process.env.SOUNDZA_API_KEY}\` },
  });
  return new Response(res.body, { status: res.status, headers: { "Content-Type": "application/json" } });
}

// app/api/sounds/[id]/file/route.ts: call it from your server when a user adds a sound
export async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  const query = new URL(req.url).searchParams; // search_id, and your own user id as user
  const res = await fetch(\`https://api.soundza.com/v1/sounds/${encodeURIComponent(id)}/file?${query}\`, {
    headers: { Authorization: \`Bearer ${process.env.SOUNDZA_API_KEY}\` },
    redirect: "manual",
  });
  const location = res.headers.get("location");
  return location ? Response.redirect(location, 302) : new Response(res.body, { status: res.status });
}

जब कोई उपयोगकर्ता ध्वनि जोड़ता है, तो अपने सर्वर से फ़ाइल रूट लाएँ और फ़ाइल को अपने स्वयं के स्टोरेज में सहेजें। यह डाउनलोड की गिनती करता है। रूट एक हस्ताक्षरित लिंक पर पुनर्निर्देशित करता है जो 5 मिनट तक रहता है और किसी अन्य साइट के ब्राउज़र से नहीं पढ़ा जा सकता है, इसलिए इसे क्लाइंट-साइड से न लाएँ या लिंक को न रखें। यदि आप प्रति-उपयोगकर्ता रिपोर्ट चाहते हैं, तो अपना स्वयं का उपयोगकर्ता आईडी user के रूप में पास करें।

FAQ

क्या API मुफ्त है?

हाँ। API और कुंजियाँ मुफ्त हैं। बदले में, हमें आपकी बनाई चीज़ में जहाँ उपयुक्त लगे soundza से वापस लिंक पसंद आएगा।

क्या मुझे soundza को श्रेय देने की आवश्यकता है?

हम इसे तब माँगते हैं जब आपकी टीम के बाहर के लोग आपकी बनाई चीज़ देखें, जो भी रूप उपयुक्त हो: आपकी साइट, आपके स्टोर पेज या आपके वीडियो विवरण पर एक लिंक। जब आप निर्माण या परीक्षण कर रहे हों, या केवल अपने लिए चीज़ों के लिए कुछ भी आवश्यक नहीं है।

श्रेय के रूप में क्या गिना जाता है?

soundza.com का एक लिंक जहाँ लोग इसे देख सकें। एक ऐप के लिए, आपके साउंड पिकर के पास Powered by soundza और आपकी साइट के फुटर, अबाउट पेज, ब्लॉग, या कहीं और जो समझ में आए, एक लिंक। एक गेम के लिए, जहाँ आप इसे साझा करते हैं वहाँ एक धन्यवाद: एक Reddit या Discord पोस्ट, आपका डेवलॉग या साइट, या उसका itch.io या Steam पेज। एक वीडियो के लिए, विवरण में Sound effects: soundza.com। X, Discord या YouTube पर एक शाउट-आउट भी अच्छा है।

क्या आप मेरी बनाई चीज़ साझा करेंगे?

हमें यह सुनकर खुशी होगी कि आप क्या बनाते हैं। admin@soundza.com पर ईमेल करें या @soundza_audio को टैग करें और हमें बताएँ कि आपने क्या बनाया। हम soundza के साथ बनाई गई अच्छी परियोजनाओं को फिर से साझा करते हैं।

क्या मैं soundza लोगो का उपयोग कर सकता हूँ?

हाँ, हमें खुशी होगी कि आप इसे अपने "Powered by soundza" लिंक के साथ दिखाएँ, हालाँकि यह वैकल्पिक है। कृपया इसे अपने ऐप के आइकन के रूप में उपयोग न करें। पूरा लोगो (soundza.com/logo-wordmark.png) या अकेला मार्क (soundza.com/logo.svg) डाउनलोड करें।

सीमाएँ क्या हैं?

मुफ्त कुंजियों को प्रति मिनट 60 खोजें, प्रति घंटे 250 डाउनलोड और प्रति दिन 350 मिलते हैं, जो आपके खाते की सभी कुंजियों द्वारा साझा किए जाते हैं। पूर्वावलोकन गिनती नहीं करते। हर प्रतिक्रिया में X-RateLimit-* हेडर होते हैं।

मुझे उच्च सीमाएँ कैसे मिलें?

मुफ्त सीमाएँ एक गेम बनाने, वीडियो संपादित करने, या साउंड पिकर वाले छोटे ऐप के लिए पर्याप्त हैं। यदि आप वास्तविक ट्रैफ़िक वाले ऐप में साउंड पिकर डाल रहे हैं, तो कुंजी पृष्ठ पर "Request higher limits" का उपयोग करें और हमें इसके बारे में थोड़ा बताएँ, या अपनी कुंजी उपसर्ग और आप क्या बना रहे हैं के साथ admin@soundza.com पर ईमेल करें। हम ईमेल द्वारा उत्तर देंगे।

क्या मैं व्यावसायिक परियोजनाओं में ध्वनियों का उपयोग कर सकता हूँ?

हाँ। हर ध्वनि Soundza Standard License के तहत व्यक्तिगत और व्यावसायिक कार्यों के लिए रॉयल्टी-मुक्त है, और आपके बनाए गए गेम या ऐप के अंदर ध्वनि भेजना ठीक है।

क्या मैं फ़ाइलें संग्रहीत कर सकता हूँ?

हाँ। प्रत्येक फ़ाइल को एक बार सहेजें और ध्वनि के id द्वारा उसका पुनः उपयोग करें। एक मुफ्त कुंजी 500 तक डाउनलोड की गई ध्वनियाँ संग्रहीत कर सकती है। उस हस्ताक्षरित लिंक को न रखें जिस पर download_url पुनर्निर्देशित करता है; यह 5 मिनट तक रहता है।

यदि कोई ध्वनि हटा दी जाए तो क्या होगा?

अब और फिर (कम से कम मासिक) GET /v1/removals?since=<date> को कॉल करें और उसके द्वारा सूचीबद्ध किसी भी ध्वनि को हटा दें।

क्या मैं AI प्रशिक्षित करने के लिए ध्वनियों का उपयोग कर सकता हूँ?

नहीं। ध्वनियों का उपयोग AI या मशीन-लर्निंग मॉडल को प्रशिक्षित, फाइन-ट्यून या बनाने के लिए नहीं किया जा सकता।

क्या मैं API पर साउंड लाइब्रेरी बना सकता हूँ?

नहीं। कृपया ध्वनियों को स्टैंडअलोन फ़ाइलों या सैंपल पैक के रूप में पुनर्वितरित न करें, या प्रतिस्पर्धी साउंड लाइब्रेरी या API न बनाएँ।

REST या MCP?

दोनों एक ही कुंजी, सीमाएँ और कैटलॉग का उपयोग करते हैं। अपने कोड से REST का उपयोग करें, और MCP (mcp.soundza.com/mcp) का उपयोग करें ताकि Claude Code या Cursor जैसा एजेंट आपके लिए खोज और डाउनलोड कर सके।

क्या मेरा कोडिंग एजेंट स्वयं कुंजी प्राप्त कर सकता है?

हाँ। इसे soundza.com पर ध्वनियाँ खोजने के लिए कहें। यह llms.txt पढ़ता है, आपको अनुमोदन के लिए एक लिंक भेजता है, और कुंजी सहेजता है।