Κλειδιά API και MCP
Δημιουργήστε κλειδιά API, καλέστε κάθε δημόσιο REST endpoint και συνδέστε τον επίσημο MCP server του Speechdash.
Χρησιμοποιήστε Ρυθμίσεις → API για να δημιουργήσετε κλειδιά και να συνδέσετε βοηθούς. Το ίδιο κλειδί sh_live_… εξουσιοδοτεί τόσο το δημόσιο REST API όσο και τον επίσημο MCP server. Οι συνδέσεις κάτω από Ρυθμίσεις → Συνδέσεις είναι διαφορετική λειτουργία: προσαρμόζουν τρίτους MCP servers στο εσωτερικό της εφαρμογής συνομιλίας.
Δημιουργία κλειδιού
- Άνοιξε Ρυθμίσεις → API.
- Πατήστε Νέο κλειδί, δώστε του όνομα (π.χ.
Παραγωγικό server) και αντιγράψτε το αμέσως. Αποθηκεύεται μόνο το πρόθεμα, ενώ το πλήρες μυστικό εμφανίζεται μόνο μία φορά. - Αποστείλτε
Authorization: Bearer sh_live_…από τον δικό σας server. Μην τοποθετείτε ποτέ ένα κλειδί σε περιήγηση, εφαρμογή κινητού ή δημόσιο αποθετήριο.
Μπορείτε να διατηρήσετε έως και 10 ενεργά κλειδιά. Ανακαλέστε ένα διαρροφθέν κλειδί από την ίδια σελίδα.
Επαλήθευση κλειδιού με GET /v1/me (ηλεκτρονικό ταχυδρομείο, σχέδιο και πορτοφόλι). Βασική διεύθυνση: https://api.speechdash.com/v1.
REST endpoints
Κάθε δημόσιο HTTP δρόμο:
| Μέθοδος | Περιήγηση | Σκοπός |
|---|---|---|
GET | /health | Υγεία υπηρεσίας (χωρίς κλειδί API; όχι υπό /v1) |
GET | /v1/openapi.json | Σύμβαση OpenAPI 3.1 |
GET | /v1/me | Λογαριασμός, σχέδιο και πορτοφόλι |
GET | /v1/documents | Κατάλογος εγγράφων βιβλιοθήκης, συμπεριλαμβανομένων των τελειωμένων μεταγραφών |
POST | /v1/documents | Δημιουργία κειμένου (source=api) |
GET | /v1/documents/{document_id} | Ανάγνωση εγγράφου και του κειμένου του |
PUT | /v1/documents/{document_id} | Ενημέρωση τίτλου, κειμένου, γλώσσας, is_archived, ή visibility |
DELETE | /v1/documents/{document_id} | Διαγραφή εγγράφου |
POST | /v1/documents/{document_id}/translate | Νέα μεταφρασμένη έκδοση (ίδια πιστώσεις με εξαγωγή MP3) |
GET | /v1/documents/{document_id}/export | Κατεβάστε pdf, docx, txt, csv, srt, ή vtt |
POST | /v1/audio/speech | Σύνθεση έως 5.000 χαρακτήρων (JSON + ήχος) |
POST | /v1/audio/stream | Ρεύμα WAV, έως 20.000 χαρακτήρες |
POST | /v1/audio/stream/with-timestamps | SSE με ήχο ανά πρόταση και σημειώσεις |
GET | /v1/voices | Κατάλογος φωνών |
GET | /v1/voices/{voice_id} | Μια προεπιλογή φωνής (π.χ. F1) |
Το API δεν ξεκινάει εργασίες μεταγραφής ήχου ή βίντεο. Τελειωμένες εργασίες εμφανίζονται ως έγγραφα βιβλιοθήκης (source=transcription). Ενεργές σελίδες δοκιμής: Λογαριασμός, Έγγραφα, Ήχος, Φωνές.
MCP εργαλεία
Ο επίσημος server στο https://mcp.speechdash.com/mcp εκθέτει ένα εργαλείο για κάθε βιβλιοθήκη ή ενέργεια ομιλίας. Η ChatGPT χρησιμοποιεί OAuth. Η Cursor και Claude Desktop χρησιμοποιούν Streamable HTTP με το προσωπικό σας κλειδί API.
| Εργαλείο MCP | 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 |
Πηγή: speechdash://openapi (ζωντανό JSON OpenAPI).
Η ροή ομιλίας (POST /v1/audio/stream και POST /v1/audio/stream/with-timestamps) δεν έχει εργαλείο MCP. Χρησιμοποιήστε REST για αυτές τις διαδρομές και για /health.
Ρυθμίσεις: MCP server και το Agents hub.
Πιστώσεις
Η σύνθεση ομιλίας (REST και MCP) καταναλώνει 0.5 πιστώσεις για κάθε ξεκινούμενο 30 δευτερόλεπτο γενικού ήχου. Η μετάφραση χρησιμοποιεί τον ίδιο ρυθμό με την εξαγωγή MP3. Η δημιουργία εγγράφων και η εξαγωγή αρχείων δεν καταναλώνουν πιστώσεις. Η δημιουργία εγγράφων υπολογίζεται στο ημερήσιο όριο εγγράφων του σχεδίου σας.
Δείτε Τι καταναλώνει πιστώσεις.