APIMaster.ai

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_id sesi, model_id modeli, language_code dili seçer. voice_settings okuma biçimini düzenler. Her inputs öğesi bir repliğin metnini ve sesini içerir.
  • Sesi file olarak yükleyin. diarize konuşmacıları ayırır ve timestamps_granularity zaman damgasının ayrıntısını belirler. Canlı kullanımda PCM parçalarını Base64 ile gönderin, commit ile tamamlayın ve committed_transcript olayını bekleyin.
  • Dönüştürmede voice_id hedef sestir. Ses tasarımı üç önizleme döndürür. text en az 100 karakter olmalıdır.
  • Efektlerde duration_seconds 0,5–30 saniye kabul eder. Müzik için prompt veya composition_plan kullanın. prompt ile music_length_ms süreyi, force_instrumental vokalsiz çıktıyı belirler.
  • Dublajda project_id ile proje ve hedef dil durumunu izleyin. Tamamlanınca outputs.lossless_audio dosyası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ı

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.

Resmî fiyatlar