Tahirin-kevitra API
Ampidiro ao anatin'ny rindran'asao ny Speech to Speech AI amin'ny alalan'ny API REST tsotra.
Fiandohana haingana
Manomboka amin'ny API Speech to Speech AI ao anatin'ny 5 minitra.
URL fototra
https://api.speechtospeechai.com/v1
1. Manomboka asa iray
POST miaraka amin'ny famaha API-nao ny fitaovana tsirairay. ID-n'ny asa no valin'izany, fa tsy ny feo.
curl -X POST https://api.speechtospeechai.com/v1/tts/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "text=Hello! Welcome to Speech to Speech AI." \
-F "model=kokoro" \
-F "voice_id=af_heart" \
-F "format=mp3"
{"uuid": "3f2c...", "job_id": "...", "status": "queued"}
2. Fifidianana ho an'ny vokatra
Mangataka ny asa isaky ny segondra vitsy mandra-pahatongan'ny famaranana ny toe-draharaha, avy eo misintona ny result_url.
curl "https://api.speechtospeechai.com/v1/speech/results/?uuid=3f2c..." \
-H "Authorization: Bearer YOUR_API_KEY"
{"status": "completed", "result_url": "https://.../output.mp3"}
Fanamarinana
Mila fanamarinana amin'ny alalan'ny famaha API ao amin'ny Authorization loha-pejy.
Authorization: Bearer YOUR_API_KEY
Fandraisana feo
/v1/voice-clone/
Miteny lahatsoratra amin'ny feo amin'ny alalan'ny raki-peo fohy.
Ny vatanan'ilay fangatahana (multipart/form-data)
| Mpizahaky ny macro | Karazana | Tsy maintsy atao | Fanoritsoritana |
|---|---|---|---|
reference_audio |
file | Eny | Fandraiketana ny feo hosokafana (10-30 segondra no toro-hevitra, hatramin'ny 60) |
text |
string | Eny | Soratra holazaina amin'io feo io |
model |
string | Tsy misy | chatterbox, openvoice, tortoise na gpt-sovits |
language |
string | Tsy misy | Fangon'ny teny (tsotra: en) |
Valiny
IDn'ny asa (uuid). GET /v1/speech/results/?uuid= mandra-pahatongan'ny famaranana ny toe-draharaha ary misintona ny result_url.
Soratra ho lasa feo
/v1/tts/
Manova ny lahabolana ho feo.
Ny vatanan'ilay fangatahana (multipart/form-data)
| Mpizahaky ny macro | Karazana | Tsy maintsy atao | Fanoritsoritana |
|---|---|---|---|
text |
string | Eny | Ny lahabolana ho ovaina (marika 5000 farafahakeliny) |
model |
string | Tsy misy | kokoro (tsotra), piper, vits na bark |
voice_id |
string | Tsy misy | IDn'ny feo avy amin'ny GET /v1/speech/voices/?model= |
language |
string | Tsy misy | Fangon'ny teny (tsotra: en) |
speed |
float | Tsy misy | Mpamaha hafainganam-pandeha (0.5-2.0, 1.0 tsotra) |
format |
string | Tsy misy | wav (tsotra), mp3, ogg na flac. Voafafa alohan'ny famoronana ny tag SSML. |
Valiny
IDn'ny asa (uuid). GET /v1/speech/results/?uuid= mandra-pahatongan'ny famaranana ny toe-draharaha ary misintona ny result_url.
Hanova ny feo ho lahabolana
/v1/transcribe/
Manova feo ho lasa lahatsoratra miaraka amin'ny famantarana fotoana.
Ny vatanan'ilay fangatahana (multipart/form-data)
| Mpizahaky ny macro | Karazana | Tsy maintsy atao | Fanoritsoritana |
|---|---|---|---|
file |
file | Eny | Rakitra audio/video hosoratana |
model |
string | Tsy misy | large-v3 (tsotra) na turbo |
language |
string | Tsy misy | Famaha ny teny, na ny fomba hitazomana azy hoazy (tsotra) |
enable_word_timestamps |
bool | Tsy misy | Ampidiro ny fotoana fanombohana sy fiafarana amin'ny teny tsirairay |
callback_url |
string | Tsy misy | URL handray ny vokatra amin'ny alalan'ny POST rehefa vita ilay asa |
Valiny
IDn'ny asa (uuid). GET /v1/transcribe/results/?uuid= ny fanontaniana mandra-pahatongan'ny famaranana ny toe-draharaha; ny valinteny dia ahitana lahabolana, teny ary segments.
Modely misy
Modelin'ny fandikana lahabolana
| ID'ny modely | Fanoritsoritana | Tsara indrindra ho an'ny |
|---|---|---|
kokoro |
TTS maro teny haingana | Fampiasa ankapobeny, tsy misy fiatoana |
piper |
TTS mora ampiasaina amin'ny teny maro (feo nahazoana alalana ho an'ny varotra ihany) | Mampiseho haingana amin'ny teny 11 |
vits |
LJSpeech miaraka amin'ireo mpiteny Anglisy VCTK 108 | Teny Anglisy |
bark |
TTS generative, safidy mialoha 130 amin'ny teny 13 | Miovaova, fanehoana ny fihetseham-po (miato) |
openvoice |
Fandraisana an-tànana feo sy fanovana feo safidy | Safidy hafa an'ny Chatterbox |
chatterbox |
Fandraisana an-tsokosoko ny feo amin'ny teny 23; modely fanovàna feo tsotra | Fandraisana tahaka avy amin'ny santionany fohy |
Modelin'ny fiteny ho an'ny lahabolana
| ID'ny modely | Fanoritsoritana | Tsara indrindra ho an'ny |
|---|---|---|
whisper-large-v3 |
OpenAI Whisper Large v3 | Fitaovana |
whisper-turbo |
Whisper tsara indrindra ho an'ny hafainganan'ny | Fandikana haingana |
Famaha tsy fetezana
| Fandrindrana | Fivoarana | Fanoritsoritana |
|---|---|---|
invalid_api_key |
401 | Famaha API diso na tsy misy |
insufficient_credits |
402 | Tsy ampy ny credits ho an'ity asa ity |
rate_limit_exceeded |
429 | Maro loatra ireo fangatahana |
invalid_request |
400 | Tsy mety ny vatan'ilay fangatahana |
model_not_found |
404 | Tsy misy ilay modely nangatahana |
voice_not_found |
404 | Tsy misy ilay feo nangatahana |
file_too_large |
413 | Mihoatra ny fetra ny haben'ilay rakitra nalefa |
server_error |
500 | Tsy fetezan'ny mpizara anatiny |