MiniMax: Speech 02 Turbo
Speech 02 Turbo is een tekst-naar-spraakmodel van MiniMax om een voltooid script om te zetten in audio. De editie minimax/speech-02-turbo biedt instellingen voor stem, voordracht en audioformaat, met een volledig JSON-antwoord en een keuze uit URL- of hexadecimale audio-uitvoer. Gebruik het om een voorbereide aankondiging, productuitleg of vertelscript om te zetten in gesproken audio.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Speech 02 Turbo is de exacte MiniMax-spraakeditie die wordt geselecteerd met model: "minimax/speech-02-turbo". Gebruik POST /v1/audio/speech met een application/json-body met model en de uit te spreken text. De invoer is een geschreven script en het resultaat is gesynthetiseerde audio. Plaats voor een aankondiging alleen de woorden die moeten worden uitgesproken in text, zoals een kort afhaalbericht. Verdeel voor een productuitleg het script in volledige zinnen en leg de productnamen en getallen vast voordat je audio genereert. Houd productienotities, bestandsnamen en aanwijzingen die niet hoorbaar mogen zijn buiten het gesproken script.
Het veld text mag niet leeg zijn en moet minder dan 10 000 Unicode-tekens bevatten. Stuur het volledige gesproken script met stream:false of laat stream weg. Verdeel langer materiaal in afzonderlijke volledige scriptsegmenten voordat je elk segment indient. Je kunt een document gebruiken door de daadwerkelijke inhoud te lezen en de relevante passage in text te plaatsen; een document-URL vervangt het script niet.
Kies een stem via voice_setting.voice_id. De gedocumenteerde stemcategorieën omvatten systeemstemmen en reeds aangemaakte gekloonde of via tekst ontworpen stemmen; gebruik een geldige stem-ID voor de geselecteerde categorie. De voorbeeldstem is audiobook_male_1. Hetzelfde object regelt speed van 0.5 tot 2, vol boven 0 en tot 10 en pitch als geheel getal van -12 tot 12. De standaardwaarden zijn 1, 1 en 0. Deze instellingen passen verschillende aspecten van de gesproken voordracht aan, dus kies ze afzonderlijk in plaats van hun namen in het script te plaatsen.
voice_setting.emotion accepteert happy, sad, angry, fearful, disgusted, surprised, calm en fluent. De documentatie beschrijft ook automatische afstemming van de emotie op de tekst. Voor scripts met veel getallen schakelt voice_setting.text_normalization Chinese en Engelse tekstnormalisatie in en heeft false als standaardwaarde. voice_setting.latex_read regelt het voorlezen van LaTeX-uitdrukkingen en heeft eveneens false als standaardwaarde. pronunciation_dict.tone is een array van tekenreeksen met uitspraakregels. Het gepubliceerde voorbeeld is ["草地/(cao3)(di1)"]; behoud het woord, de schuine streep en de uitspraakstructuur tussen haakjes wanneer je een regel aanlevert.
audio_setting.format accepteert mp3, pcm, flac en wav, met mp3 als standaardwaarde. sample_rate accepteert 8000, 16000, 22050, 24000, 32000 en 44100 Hz; de standaardwaarde is 32000. channel is 1 voor mono of 2 voor twee kanalen, met 1 als standaardwaarde. De bitrate-waarden zijn 32000, 64000, 128000 en 256000 bits per seconde, met 128000 als standaardwaarde, en zijn van toepassing op mp3. Selecteer de codering die de speler of het bewerkingsprogramma dat het resultaat gaat gebruiken nodig heeft.
language_boost is een optionele tekenreeks met null als standaardwaarde. De toegestane waarden zijn Chinese, Chinese,Yue, English, Arabic, Russian, Spanish, French, Portuguese, German, Turkish, Dutch, Ukrainian, Vietnamese, Indonesian, Japanese, Italian, Korean, Thai, Polish, Romanian, Greek, Czech, Finnish, Hindi, Bulgarian, Danish, Hebrew, Malay, Persian, Slovak, Swedish, Croatian, Filipino, Hungarian, Norwegian, Slovenian, Catalan, Nynorsk, Tamil, Afrikaans en auto. "Chinese,Yue" is één waarde. Het is een afzonderlijke instelling, los van het script en de stem-ID. Het schema biedt ook timber_weights voor een lijst van paren met voice_id en weight, waarbij elke waarde voor weight een geheel getal van 1 tot 100 is. Behoud de parameterspelling timber_weights wanneer je een verzoek voorbereidt. voice_modify.sound_effects is een optionele tekenreeks met de waarden spacious_echo, auditorium_echo, lofi_telephone en robotic.
stream heeft false als standaardwaarde. Voor een volledig antwoord selecteert output_format url of hex en heeft hex als standaardwaarde. In het gedocumenteerde JSON-resultaat bevat data.audio de geselecteerde weergave: download de volledige ondertekende Ailoot-URL, inclusief de querytekenreeks, of decodeer de volledige hexadecimale audio naar bytes. Bewaar het oorspronkelijke resultaat samen met data.status, base_resp, trace_id en extra_info, dat het daadwerkelijke audioformaat, de bemonsteringsfrequentie, het aantal kanalen, de grootte en usage_characters bevat.
subtitle_enable is een booleaanse waarde met false als standaardwaarde en is van toepassing op niet-gestreamde uitvoer. aigc_watermark is een booleaanse waarde met false als standaardwaarde en regelt een hoorbare ritmemarkering aan het einde van de gegenereerde audio. Bewaar elk geretourneerd audio- of ondertitelresultaat en controleer uitspraak, getallen en het voltooide bestand voordat je het in de toepassing plaatst. Als de levering onzeker is, bewaar dan de oorspronkelijke verzoekidentificatie en het antwoord om de bestaande poging te controleren. Ailoot slaat de voltooide audio ook op in je mediabibliotheek. Met output_format:"url" bevat data.audio een ondertekende link naar die opgeslagen asset; de asset-ID staat in het pad /v1/media/assets/{asset_id}/content. Ondertekende Ailoot-bestandslinks zijn 24 uur geldig vanaf uitgifte. Gebruik dezelfde API-sleutel voor GET /v1/media/assets?family=audio en volg elke next_cursor om de audio-assetrecords te vinden. Lees GET /v1/media/assets/{asset_id} voor elk geselecteerd record en download de exacte content_url, inclusief de querytekenreeks. Als een bestandsverzoek 404 met code link_expired retourneert, lees je dezelfde asset opnieuw voor een vernieuwde content_url. Vernieuw het opgeslagen resultaat in plaats van opnieuw audio te genereren om een verlopen link te vervangen.
Ailoot Ultra · Speech POST /v1/audio/speech minimax/speech-02-turbo
minimax/speech-02-turboAan de slag
Speech 02 Turbo is een tekst-naar-spraakmodel van MiniMax om een voltooid script om te zetten in audio. De editie minimax/speech-02-turbo biedt instellingen voor stem, voordracht en audioformaat, met een volledig JSON-antwoord en een keuze uit URL- of hexadecimale audio-uitvoer. Gebruik het om een voorbereide aankondiging, productuitleg of vertelscript om te zetten in gesproken audio.
- Toegestane invoer
- Tekst
- Resultaten
- Audio
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Speech POST /v1/audio/speech
- Invoer
text- Uitvoer
audio- Uitvoerformaat
- mp3,pcm,flac,wav
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten minimax/speech-02-turbo | Standaard— |
Veldtext | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten false | Standaardfalse |
Veldvoice_setting | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldvoice_setting.voice_id | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldvoice_setting.speed | Typenumber | VereisteOptioneel | Waarden en limieten Minimum: 0,5 Maximum: 2 | Standaard1 |
Veldvoice_setting.vol | Typenumber | VereisteOptioneel | Waarden en limieten Minimum: 0 Maximum: 10 | Standaard1 |
Veldvoice_setting.pitch | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: -12 Maximum: 12 | Standaard0 |
Veldvoice_setting.emotion | Typestring | VereisteOptioneel | Waarden en limieten happy, sad, angry, fearful, disgusted, surprised, calm, fluent | Standaard— |
Veldvoice_setting.text_normalization | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldvoice_setting.latex_read | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldaudio_setting | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldaudio_setting.sample_rate | Typeinteger | VereisteOptioneel | Waarden en limieten 8.000, 16.000, 22.050, 24.000, 32.000, 44.100 | Standaard32.000 |
Veldaudio_setting.bitrate | Typeinteger | VereisteOptioneel | Waarden en limieten 32.000, 64.000, 128.000, 256.000 | Standaard128.000 |
Veldaudio_setting.format | Typestring | VereisteOptioneel | Waarden en limieten mp3, pcm, flac, wav | Standaardmp3 |
Veldaudio_setting.channel | Typeinteger | VereisteOptioneel | Waarden en limieten 1, 2 | Standaard1 |
Veldaudio_setting.force_cbr | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldpronunciation_dict | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldpronunciation_dict.tone | Typearray | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldtimber_weights | Typearray | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldlanguage_boost | Typestring | VereisteOptioneel | Waarden en limieten Chinese, Chinese,Yue, English, Arabic, Russian, Spanish, French, Portuguese, German, Turkish, Dutch, Ukrainian, Vietnamese, Indonesian, Japanese, Italian, Korean, Thai, Polish, Romanian, Greek, Czech, Finnish, Hindi, Bulgarian, Danish, Hebrew, Malay, Persian, Slovak, Swedish, Croatian, Filipino, Hungarian, Norwegian, Slovenian, Catalan, Nynorsk, Tamil, Afrikaans, auto | Standaard— |
Veldvoice_modify | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldvoice_modify.pitch | Typeinteger | VereisteOptioneel | Waarden en limieten -100, 100 | Standaard— |
Veldvoice_modify.intensity | Typeinteger | VereisteOptioneel | Waarden en limieten -100, 100 | Standaard— |
Veldvoice_modify.timbre | Typeinteger | VereisteOptioneel | Waarden en limieten -100, 100 | Standaard— |
Veldvoice_modify.sound_effects | Typestring | VereisteOptioneel | Waarden en limieten spacious_echo, auditorium_echo, lofi_telephone, robotic | Standaard— |
Veldsubtitle_enable | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Veldoutput_format | Typestring | VereisteOptioneel | Waarden en limieten url, hex | Standaardhex |
Veldaigc_watermark | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, text |
Parameteroptional | Contractstream, voice_setting, audio_setting, pronunciation_dict, timber_weights, language_boost, voice_modify, subtitle_enable, output_format, aigc_watermark |
Parametermaterial_types | Contracttext |
Parameterconditions | ContractUse text, not input or contents. Fewer than 10000 Unicode characters; stream is false or omitted., PCM is raw audio with its returned sample geometry; do not invent a WAV header or bit depth. |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt
Ailoot-tarieven
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Rekeneenheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Rekeneenheid— | Kosten Invoer · Invoertokens — / 1K tokens Uitvoer · Uitvoertokens — / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| Configuratieinvoerteken | Tariefstaffel— | Rekeneenheidper invoerteken | Kosten Invoer · invoerteken $0.00012 per invoerteken |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Speech
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "minimax/speech-02-turbo", "text": "Hello, this is a short speech example.", "stream": false, "output_format": "hex", "audio_setting": {"format": "mp3", "sample_rate": 32000, "channel": 1}}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Resultaten ophalen en opslaan
Ailoot Ultra · Speech
mp3,pcm,flac,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Retain the full JSON. Decode every hex audio byte or use the returned owned URL. Keep the actual format, sample rate, channel count and usage_characters.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Antwoordvelden
| Veld | Type |
|---|---|
Velddata.audio | Typestring |
Veldextra_info | Typeobject |
Veldtrace_id | Typestring |
Aliasnamen
Modelaliasnamen
Ailoot Ultra minimax/speech-02-turbo
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · MiniMax: Speech 02 Turbo
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/audio/speech·minimax/speech-02-turbo:text→audio- Welke velden gebruikt het verzoek?
POST /v1/audio/speech·minimax/speech-02-turbo:model,text,stream,voice_setting,audio_setting,pronunciation_dict,timber_weights,language_boost,voice_modify,subtitle_enable,output_format,aigc_watermark- Welke limieten gelden?
POST /v1/audio/speech·minimax/speech-02-turbo:voice_setting.speed.minimum:0.5;voice_setting.speed.maximum:2;voice_setting.vol.minimum:0;voice_setting.vol.maximum:10;voice_setting.pitch.minimum:-12;voice_setting.pitch.maximum:12