API-avaimet ja MCP
Luo API-avaimet, käytä kaikkia julkisia REST-päätettä ja liitä virallinen Speechdash MCP-palvelin.
Käytä Asetukset → API -kohtaa avaimien luomiseen ja apujen liittämiseen. Samalla sh_live_… -avaimella voit valtuuttaa sekä julkisen REST-API:n että virallisen MCP-palvelimen. Asetukset → Liittimet -kohtaan kuuluvat erillinen ominaisuus: ne liittävät kolmannen osapuolen MCP-palvelimet sovelluksen sisäiseen chattiin.
Luo avain
- Avaa Asetukset → API.
- Napsauta Uusi avain, anna sille nimi (esimerkiksi
Tuotanto-palvelin) ja kopioi se välittömästi. Vain etumerkki tallennetaan; täysi salainen avain näytetään vain kerran. - Lähetä
Authorization: Bearer sh_live_…-päätepalvelimeltasi. Älä koskaan aseta avainta selaimessa, mobiilisovelluksessa tai julkisessa repo:ssa.
Voit pitää enintään 10 aktiivista avainta. Voit peruuttaa vuotaneen avaimen samalta sivulta.
Tarkista avain GET /v1/me -päätteellä (sähköposti, tili ja lompakko). Peruspäätteen osoite: https://api.speechdash.com/v1.
REST-päätteet
Kaikki julkiset HTTP-reitit:
| Metodi | Polku | Käyttö |
|---|---|---|
GET | /health | Palvelun terveys (ei API-avaimia; ei /v1 alla) |
GET | /v1/openapi.json | OpenAPI 3.1 sopimus |
GET | /v1/me | Tilin tiedot, tila ja lompakko |
GET | /v1/documents | Luettelo kirjastoasiakirjoista, mukaan lukien valmiit transkriptiot |
POST | /v1/documents | Luo tekstiasiakirja (source=api) |
GET | /v1/documents/{document_id} | Lue asiakirja ja sen teksti |
PUT | /v1/documents/{document_id} | Päivitä otsikko, teksti, kieli, is_archived tai visibility |
DELETE | /v1/documents/{document_id} | Poista asiakirja |
POST | /v1/documents/{document_id}/translate | Uusi käännetty versio (samat pisteet kuin MP3-exportti) |
GET | /v1/documents/{document_id}/export | Lataa pdf, docx, txt, csv, srt tai vtt |
POST | /v1/audio/speech | Synteettinen puhe jopa 5000 merkille (JSON + ääni) |
POST | /v1/audio/stream | Virtaava WAV, jopa 20 000 merkille |
POST | /v1/audio/stream/with-timestamps | SSE per-lauseen ääni ja merkinnät |
GET | /v1/voices | Äänikatalogi |
GET | /v1/voices/{voice_id} | Yksi ääniasetuksista (esimerkiksi F1) |
API ei aloita äänitallenteen tai videon transkriptiojättiä. Valmiit työtehtävät näkyvät kirjastoasiakirjoina (source=transcription). Käytäntöön soveltuvia kokeile-sivuja: Tili, Asiakirjat, Ääni, Äänit.
MCP-välineet
Virallinen palvelin osoitteessa https://mcp.speechdash.com/mcp tarjoaa yhden työkalun kirjasto- tai puhetoiminnalle. ChatGPT käyttää OAuthia. Cursor ja Claude Desktop käyttävät Streamable HTTP:tä omalla API-avaimella.
| MCP-työkalu | REST |
|---|---|
speechdash_get_account | GET /v1/me |
speechdash_list_documents | GET /v1/documents |
speechdash_get_document | GET /v1/documents/{document_id} |
speechdash_create_document | POST /v1/documents |
speechdash_update_document | PUT /v1/documents/{document_id} |
speechdash_translate_document | POST /v1/documents/{document_id}/translate |
speechdash_export_document | GET /v1/documents/{document_id}/export |
speechdash_delete_document | DELETE /v1/documents/{document_id} |
speechdash_list_voices | GET /v1/voices |
speechdash_get_voice | GET /v1/voices/{voice_id} |
speechdash_synthesize_speech | POST /v1/audio/speech |
Resurssi: speechdash://openapi (elävän OpenAPI JSON).
Virtaava puhe (POST /v1/audio/stream ja POST /v1/audio/stream/with-timestamps) ei tarjoa MCP-työkalua. Käytä REST-päätteitä näille reiteille ja /health päätteelle.
Asennus: MCP-palvelin ja Agents-hub.
Pisteet
Äänisynteesi (REST ja MCP) kuluttaa 0.5 pistettä jokaista 30 sekunnin kestoista synteettistä ääntä alkaen. Käännös käyttää samaa hintaa kuin MP3-exportti. Asiakirjojen luominen ja tiedostojen lataaminen eivät kuluta pisteitä. Asiakirjojen luominen lasketaan tilin päivittäiseen asiakirja-rajaan.
Katso Mitä kuluttaa pisteitä.