APIMaster’da ElevenLabs API
`Authorization: Bearer` başlığında APIMaster API anahtarı kullanın. Uç noktalar `/v1/elevenlabs` önekini kullanır. Parametre bağlantıları ElevenLabs belgelerine gider.
Authorization: Bearer başlığında APIMaster API anahtarı kullanın. Uç noktalar /v1/elevenlabs önekini kullanır. Parametre bağlantıları ElevenLabs belgelerine gider.
Yerel dosya yükleyin. Uzak URL ve deşifre webhook’ları kullanılamaz. Ses tasarımı için en az 100 karakterlik önizleme metni gerekir. Müzik ve efekt süresini belirtin. APIMaster WebSocket’i sağlayıcı kimlik bilgilerini yönetir. Sesi tamamladıktan sonra response.create gönderip response.done olayını bekleyin.
Modeller ve uç noktalar
| Özellik | Model kimlikleri | Resmî uç nokta | Temel parametreler |
|---|---|---|---|
| Konuşma sentezi ve diyalog | eleven_v4, eleven_v4_turbo, eleven_v3, eleven_v3_conversational, eleven_multilingual_v2, eleven_flash_v2_5, eleven_flash_v2, eleven_turbo_v2_5, eleven_turbo_v2 |
POST /v1/elevenlabs/text-to-speech/{voice_id} · POST /v1/elevenlabs/text-to-dialogue |
text · model_id · voice_settings · language_code · output_format · inputs[].voice_id · inputs[].text |
| Dosya deşifresi | scribe_v3, scribe_v2, scribe_v2_medical |
POST /v1/elevenlabs/speech-to-text |
model_id · file · language_code · diarize · timestamps_granularity · keyterms · transcript_edit |
| Gerçek zamanlı deşifre | scribe_v3_live, scribe_v2_realtime |
WSS /v1/elevenlabs/speech-to-text/realtime |
model_id · audio_format · commit_strategy · audio_base_64 · commit |
| Ses dönüştürme | eleven_multilingual_sts_v2, eleven_english_sts_v2 |
POST /v1/elevenlabs/voice-changer/{voice_id} |
audio · model_id · remove_background_noise · voice_settings · output_format |
| Ses tasarımı | eleven_ttv_v3, eleven_multilingual_ttv_v2 |
POST /v1/elevenlabs/text-to-voice/design |
model_id · voice_description · text · guidance_scale · seed |
| Ses efektleri | eleven_text_to_sound_v3, eleven_text_to_sound_v2 |
POST /v1/elevenlabs/sound-generation |
model_id · text · duration_seconds · loop · prompt_influence |
| Müzik | music_v2_5, music_v2, music_v1 |
POST /v1/elevenlabs/music |
model_id · prompt · composition_plan · music_length_ms · force_instrumental |
| Gerçek zamanlı konuşma | eleven_realtime_v1_mini, eleven_realtime_v1_max |
WSS /v1/elevenlabs/realtime |
model · input_audio_buffer.append · response.create |
| Dublaj | dubbing_v2, dubbing_v1 |
POST /v1/elevenlabs/dubbing/project |
model_id · file · source_language · target_language · project_id |
Parametreler ve yanıtlar
voice_idsesi,model_idmodeli,language_codedili seçer.voice_settingsokuma biçimini düzenler. Herinputsöğesi bir repliğin metnini ve sesini içerir.- Sesi
fileolarak yükleyin.diarizekonuşmacıları ayırır vetimestamps_granularityzaman damgasının ayrıntısını belirler. Canlı kullanımda PCM parçalarını Base64 ile gönderin,commitile tamamlayın vecommitted_transcriptolayını bekleyin. - Dönüştürmede
voice_idhedef sestir. Ses tasarımı üç önizleme döndürür.texten az 100 karakter olmalıdır. - Efektlerde
duration_seconds0,5–30 saniye kabul eder. Müzik içinpromptveyacomposition_plankullanın.promptilemusic_length_mssüreyi,force_instrumentalvokalsiz çıktıyı belirler. - Dublajda
project_idile proje ve hedef dil durumunu izleyin. Tamamlanıncaoutputs.lossless_audiodosyasını indirin.
Örnekler
curl https://apimaster.ai/v1/elevenlabs/text-to-speech/JBFqnCBsd6RMkjVDRZzb \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model_id":"eleven_v4","text":"Hello from ElevenLabs."}' \
--output speech.mp3
curl https://apimaster.ai/v1/elevenlabs/speech-to-text \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-F 'model_id=scribe_v3' -F 'file=@speech.mp3' \
-F 'diarize=true' -F 'timestamps_granularity=word'
curl https://apimaster.ai/v1/elevenlabs/music \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model_id":"music_v2_5","prompt":"Soft piano jingle","music_length_ms":3000,"force_instrumental":true}' \
--output jingle.mp3
curl https://apimaster.ai/v1/elevenlabs/dubbing/project \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-F 'model_id=dubbing_v2' -F 'file=@speech.mp3' \
-F 'source_language=en' -F 'target_language=es'
curl "https://apimaster.ai/v1/elevenlabs/dubbing/project/$PROJECT_ID" \
-H "Authorization: Bearer $APIMASTER_API_KEY"
curl "https://apimaster.ai/v1/elevenlabs/dubbing/project/$PROJECT_ID/language/$LANGUAGE_ID" \
-H "Authorization: Bearer $APIMASTER_API_KEY"
İstek biçimleri ve sınırlar
Sentez, diyalog, ses tasarımı, efekt ve müzik için en fazla 4 MiB boyutunda application/json gönderin. output_format sorgu dizesinde yer alır. Çok konuşmacılı diyaloglarda eleven_v4 veya eleven_v3 kullanın. Sentez, diyalog, ses dönüştürme, müzik veya ses yalıtımı yoluna /stream ekleyerek yanıtı parça parça alın.
multipart/form-data ile tek dosya yükleyin. Ses dönüştürme ve yalıtım için audio, transkripsiyon, hizalama, kanal ayırma ve dublaj için file kullanın. Ham mono 16 kHz, 16 bit little-endian PCM için file_format=pcm_s16le_16 kullanın.
Müzik süresi 3.000–600.000 milisaniye olmalıdır. prompt ile birlikte music_length_ms verin. composition_plan kullanırken her bölüme sabit duration_ms atayın.
Gerçek zamanlı konuşma örneği
websocket-client paketini kurun ve APIMASTER_API_KEY değerini ayarlayın. session.created sonrasında girdi gönderin. Ses response.audio.delta veya response.output_audio.delta olaylarıyla gelir. Turun durum ve kullanım bilgisi response.done olayındadır.
import json
import os
from urllib.parse import urlsplit, urlunsplit
from websocket import create_connection
base = urlsplit("https://apimaster.ai/v1")
url = urlunsplit(("wss", base.netloc, base.path.rstrip("/") + "/elevenlabs/realtime",
"model=eleven_realtime_v1_mini", ""))
socket = create_connection(
url, header={"Authorization": "Bearer " + os.environ["APIMASTER_API_KEY"]},
timeout=30,
)
try:
assert json.loads(socket.recv())["type"] == "session.created"
socket.send(json.dumps({
"type": "conversation.item.create",
"item": {"type": "message", "role": "user",
"content": [{"type": "input_text", "text": "Say hello."}]},
}))
socket.send(json.dumps({"type": "response.create"}))
while True:
event = json.loads(socket.recv())
if event["type"] == "error":
raise RuntimeError(event["error"])
if event["type"] == "response.done":
print(event["response"]["status"], event["response"].get("usage"))
break
finally:
socket.close()
Bağımsız ses uç noktaları
POST /v1/elevenlabs/audio-isolation·audio,file_formatPOST /v1/elevenlabs/forced-alignment·file,textPOST /v1/elevenlabs/music/stem-separation·file,stem_variation_id(two_stems_v1,six_stems_v1)
Faturalandırma ve uyumluluk
Sentez karakter başına, diğer ses işlemleri ilgili süre birimine göre ölçülür. Gerçek zamanlı konuşmada bağlantı dakikası ve token ayrı ölçülür. Üç ses önizlemesi için önizleme metni bir kez ücretlendirilir. music_v1 için 2027-01-31, eleven_text_to_sound_v2 için 2027-03-01 kaldırma tarihi olarak duyuruldu.
