API ElevenLabs di APIMaster
Gunakan kunci API APIMaster pada header `Authorization: Bearer`. Endpoint menggunakan awalan `/v1/elevenlabs`. Tautan parameter mengarah ke referensi ElevenLabs.
Gunakan kunci API APIMaster pada header Authorization: Bearer. Endpoint menggunakan awalan /v1/elevenlabs. Tautan parameter mengarah ke referensi ElevenLabs.
Unggah berkas lokal. URL jarak jauh dan webhook transkripsi tidak tersedia. Desain suara memerlukan minimal 100 karakter teks pratinjau. Tentukan durasi musik dan efek. WebSocket APIMaster menangani kredensial. Setelah mengirim dan menetapkan audio, kirim response.create lalu tunggu response.done.
Model dan endpoint
| Fitur | ID model | Endpoint resmi | Parameter utama |
|---|---|---|---|
| Sintesis dan dialog | 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 |
| Transkripsi berkas | scribe_v3, scribe_v2, scribe_v2_medical |
POST /v1/elevenlabs/speech-to-text |
model_id · file · language_code · diarize · timestamps_granularity · keyterms · transcript_edit |
| Transkripsi real-time | scribe_v3_live, scribe_v2_realtime |
WSS /v1/elevenlabs/speech-to-text/realtime |
model_id · audio_format · commit_strategy · audio_base_64 · commit |
| Pengubah suara | 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 |
| Desain suara | eleven_ttv_v3, eleven_multilingual_ttv_v2 |
POST /v1/elevenlabs/text-to-voice/design |
model_id · voice_description · text · guidance_scale · seed |
| Efek suara | eleven_text_to_sound_v3, eleven_text_to_sound_v2 |
POST /v1/elevenlabs/sound-generation |
model_id · text · duration_seconds · loop · prompt_influence |
| Musik | music_v2_5, music_v2, music_v1 |
POST /v1/elevenlabs/music |
model_id · prompt · composition_plan · music_length_ms · force_instrumental |
| Percakapan real-time | eleven_realtime_v1_mini, eleven_realtime_v1_max |
WSS /v1/elevenlabs/realtime |
model · input_audio_buffer.append · response.create |
| Sulih suara | dubbing_v2, dubbing_v1 |
POST /v1/elevenlabs/dubbing/project |
model_id · file · source_language · target_language · project_id |
Parameter dan respons
voice_idmemilih suara,model_idmemilih model, danlanguage_codemenetapkan bahasa. Gunakanvoice_settingsuntuk menyesuaikan gaya tutur. Setiap entriinputsberisi teks dan suara untuk satu giliran dialog.- Unggah audio sebagai
file.diarizemembedakan pembicara dantimestamps_granularitymengatur detail cap waktu. Untuk transkripsi real-time, kirim blok PCM dalam Base64, tetapkan segmen dengancommit, lalu tunggucommitted_transcript. - Pada pengubah suara,
voice_idadalah suara tujuan. Desain suara menghasilkan tiga pratinjau. Masukkan minimal 100 karakter padatext. duration_secondsuntuk efek suara menerima 0,5–30 detik. Untuk musik, pilihpromptataucomposition_plan. Bersamaprompt,music_length_msmenentukan durasi danforce_instrumentalmenghilangkan vokal.- Untuk sulih suara, periksa status proyek dan bahasa dengan
project_id, lalu unduhoutputs.lossless_audiosetelah selesai.
Contoh
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"
Format dan batas permintaan
Kirim sintesis, dialog, desain suara, efek, dan musik sebagai application/json hingga 4 MiB. Masukkan output_format pada string kueri. Dialog dengan beberapa pembicara menerima eleven_v4 dan eleven_v3. Tambahkan /stream ke jalur sintesis, dialog, pengubah suara, musik, atau isolasi untuk membaca respons secara bertahap.
Unggah satu berkas dengan multipart/form-data. Gunakan audio untuk pengubah suara dan isolasi, serta file untuk transkripsi, penyelarasan, pemisahan trek, dan sulih suara. Untuk PCM mentah mono 16 kHz 16-bit little-endian, gunakan file_format=pcm_s16le_16.
Durasi musik 3.000–600.000 milidetik. Sertakan music_length_ms bersama prompt. Jika memakai composition_plan, tetapkan duration_ms untuk setiap segmen dan pertahankan durasinya.
Contoh percakapan realtime
Pasang websocket-client dan atur APIMASTER_API_KEY. Kirim masukan setelah session.created. Audio masuk melalui response.audio.delta atau response.output_audio.delta. Baca status dan penggunaan giliran pada response.done.
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()
Endpoint audio terpisah
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)
Penagihan dan kompatibilitas
Sintesis dihitung per karakter dan fitur audio lainnya menurut satuan durasinya. Percakapan real-time menghitung menit koneksi dan token. Tiga pratinjau desain suara dikenai biaya teks satu kali. music_v1 dijadwalkan dihapus pada 2027-01-31 dan eleven_text_to_sound_v2 pada 2027-03-01.
