API anahtarları ve MCP
API anahtarları oluşturun, herhangi bir kamu REST uç noktasını çağırın ve resmi Speechdash MCP sunucusuna bağlanın.
Ayarlar → API'yi kullanarak anahtarları oluşturun ve yardımcı programları bağlayın. Aynı sh_live_… anahtarı kamu REST API'si ve resmi MCP sunucusunu yetkilendirir. Ayarlar → Bağlantılar altında bulunan bağlantılar farklı bir özelliktir: bunlar, uygulama içi sohbete üçüncü taraf MCP sunucularını ekler.
Bir anahtar oluşturun
- Ayarlar → API'yi açın.
- Yeni anahtar'ı tıklayın, ona bir isim verin (örneğin
Üretim sunucusu), ve hemen kopyalayın. Sadece önek saklanır; tam sırrı bir kez gösterilir. - Anahtarınızı
Authorization: Bearer sh_live_…olarak sunucunuzdan gönderin. Bir anahtarı tarayıcıda, mobil uygulamada veya kamuya açık bir depoda asla kullanmayın.
10 aktif anahtar saklayabilirsiniz. Aynı sayfadan sızan bir anahtarı iptal edin.
GET /v1/me ile bir anahtarı doğrulayın (e-posta, plan ve cüzdan). Temel URL: https://api.speechdash.com/v1.
REST uç noktaları
Her kamu HTTP rotası:
| Yöntem | Yol | Amaç |
|---|---|---|
GET | /health | Hizmet sağlığı (API anahtarı yok; /v1 altında değil) |
GET | /v1/openapi.json | OpenAPI 3.1 sözleşmesi |
GET | /v1/me | Hesap, plan ve cüzdan |
GET | /v1/documents | Kütüphane belgelerini listeleyin, bitmiş transkripsiyonları da dahil |
POST | /v1/documents | Metin belgesi oluşturun (source=api) |
GET | /v1/documents/{document_id} | Bir belgeyi ve metnini okuyun |
PUT | /v1/documents/{document_id} | Başlık, metin, dil, is_archived, veya visibility güncelleyin |
DELETE | /v1/documents/{document_id} | Bir belgenin silinmesi |
POST | /v1/documents/{document_id}/translate | Yeni çevrilmiş sürüm (MP3 ihracatıyla aynı krediler) |
GET | /v1/documents/{document_id}/export | pdf, docx, txt, csv, srt, veya vtt indirin |
POST | /v1/audio/speech | 5.000 karaktere kadar sentezleyin (JSON + ses) |
POST | /v1/audio/stream | WAV akışı, 20.000 karaktere kadar |
POST | /v1/audio/stream/with-timestamps | Cümle bazlı ses ve işaretlerle SSE |
GET | /v1/voices | Ses kataloğu |
GET | /v1/voices/{voice_id} | Bir ses ön ayarı (örneğin F1) |
API ses ve video transkripsiyon işlerini başlatmaz. Tamamlanan işler kütüphane belgeleri olarak görünür (source=transcription). Etkinlik sayfaları: Hesap, Belgeler, Ses, Sesler.
MCP araçları
Resmi sunucu https://mcp.speechdash.com/mcp her kütüphane veya konuşma eylemi için bir araç sunar. ChatGPT OAuth kullanır. Cursor ve Claude Desktop kişisel API anahtarınızla Streamable HTTP kullanır.
| MCP Araç | 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 |
Kaynak: speechdash://openapi (canlı OpenAPI JSON).
Akışlı konuşma (POST /v1/audio/stream ve POST /v1/audio/stream/with-timestamps) için MCP araçları yoktur. Bu rotalar ve /health için REST'i kullanın.
Kurulum: MCP sunucusu ve Agents hub.
Krediler
Ses sentezi (REST ve MCP) 0.5 kredi başına 30 saniyelik üretilen sesin başlangıcına harcar. Çeviri MP3 ihracatıyla aynı oranda kredi kullanır. Belgeler oluşturmak ve dosya ihracatı kredi harcamaz. Belgeler oluşturmak planınızın günlük belge sınırına sayılır.
Krediler neyi kullanır bakınız.