Chìa khóa API và MCP
Tạo chìa khóa API, gọi tất cả các điểm cuối REST công khai và kết nối máy chủ MCP chính thức của Speechdash.
Sử dụng Cài đặt → API để tạo chìa khóa và kết nối trợ lý. Chìa khóa cùng với sh_live_… sẽ xác thực cho API REST công khai và máy chủ MCP chính thức. Các kết nối dưới Cài đặt → Kết nối là một tính năng khác: chúng gắn máy chủ MCP ngoài bên thứ ba vào trò chuyện trong ứng dụng.
Tạo một chìa khóa
- Mở Cài đặt → API.
- Nhấp vào Tạo chìa khóa mới, đặt tên cho nó (ví dụ
Máy chủ Sản xuất), và sao chép ngay lập tức. Chỉ phần tiền tố được lưu trữ; toàn bộ bí mật chỉ hiển thị một lần. - Gửi
Authorization: Bearer sh_live_…từ máy chủ của bạn. Không bao giờ đặt chìa khóa vào trình duyệt, ứng dụng di động hoặc kho lưu trữ công khai.
Bạn có thể giữ tối đa 10 chìa khóa hoạt động. Hủy chìa khóa bị rò rỉ từ trang cùng.
Xác minh một chìa khóa với GET /v1/me (email, gói dịch vụ và ví). URL cơ sở: https://api.speechdash.com/v1.
Điểm cuối REST
Tất cả các đường dẫn HTTP công khai:
| Phương pháp | Đường dẫn | Mục đích |
|---|---|---|
GET | /health | Trạng thái dịch vụ (không cần chìa khóa API; không nằm dưới /v1) |
GET | /v1/openapi.json | Hợp đồng OpenAPI 3.1 |
GET | /v1/me | Tài khoản, gói dịch vụ và ví |
GET | /v1/documents | Danh sách tài liệu thư viện, bao gồm bản ghi âm hoàn thành |
POST | /v1/documents | Tạo một tài liệu văn bản (source=api) |
GET | /v1/documents/{document_id} | Đọc tài liệu và văn bản của nó |
PUT | /v1/documents/{document_id} | Cập nhật tiêu đề, văn bản, ngôn ngữ, is_archived, hoặc visibility |
DELETE | /v1/documents/{document_id} | Xóa một tài liệu |
POST | /v1/documents/{document_id}/translate | Tạo phiên bản dịch mới (sử dụng cùng số tín dụng như xuất MP3) |
GET | /v1/documents/{document_id}/export | Tải xuống pdf, docx, txt, csv, srt, hoặc vtt |
POST | /v1/audio/speech | Tạo âm thanh lên đến 5.000 ký tự (JSON + âm thanh) |
POST | /v1/audio/stream | Phát trực tiếp WAV, lên đến 20.000 ký tự |
POST | /v1/audio/stream/with-timestamps | SSE với âm thanh theo câu và dấu thời gian |
GET | /v1/voices | Danh mục giọng nói |
GET | /v1/voices/{voice_id} | Một mẫu giọng nói (ví dụ F1) |
API không khởi động các công việc ghi âm hoặc video. Các công việc hoàn thành sẽ xuất hiện như tài liệu thư viện (source=transcription). Trang thử nghiệm trực tiếp: Tài khoản, Tài liệu, Âm thanh, Giọng nói.
Công cụ MCP
Máy chủ chính thức tại https://mcp.speechdash.com/mcp cung cấp một công cụ cho mỗi thư viện hoặc hành động nói. ChatGPT sử dụng OAuth. Cursor và Claude Desktop sử dụng Streamable HTTP với chìa khóa API cá nhân của bạn.
| Công cụ 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 |
Tài nguyên: speechdash://openapi (OpenAPI JSON trực tiếp).
Phát trực tiếp âm thanh (POST /v1/audio/stream và POST /v1/audio/stream/with-timestamps) không có công cụ MCP. Sử dụng REST cho các đường dẫn này và cho /health.
Cài đặt: Máy chủ MCP và Trung tâm Trợ lý.
Tín dụng
Synthesis âm thanh (REST và MCP) tiêu tốn 0.5 tín dụng cho mỗi 30 giây âm thanh được tạo. Dịch sử dụng cùng tỷ lệ như xuất MP3. Tạo tài liệu và xuất file không tiêu tốn tín dụng. Tạo tài liệu được tính vào giới hạn tài liệu hàng ngày của gói dịch vụ của bạn.
Xem Tín dụng sử dụng gì.