Говорни API Runway Eleven v4: формат захтева и цене у октобру

Runway је 30. септембра додао Eleven v4 у свој API за програмере. белешка о издању наводи модел као eleven_v4, ограничава скрипту на 2.500 знакова и каже да ће цена у кредитима порасти 12. октобра 2026. по пацифичком времену. За програмере који додају генерисање говора у продукциони ток рада, практично питање је шта је потребно за ваљан захтев и колико документована цена износи у доларима. Овај водич заснива се на Runway документацији провереној 6. октобра; BIG CHANGE није упутио плаћени API захтев нити процењивао звук.

Велика промена

• Шта се променило: Runway сада наводи Eleven v4 као модел за претварање текста у говор у оквиру постојећег API-ја за задатке. Скрипта може да садржи документоване аудио ознаке као што су [laughs], [whispers] и [pause], у оквиру ограничења од 2.500 знакова.
• Зашто је важно: Тим са Runway пројектом за програмере може да затражи говор помоћу унапред подешеног гласа и преузме URL аудио-записа завршеног задатка. За планирање интеграције и буџета може да користи документовани формат захтева и ценовник са датумима.
• Шта треба пратити: Runway каже да се цена мења са 2,2 на 5 кредита за 1.000 знакова 12. октобра 2026. по пацифичком времену. Свако ко процењује поновљена генерисања треба да примени цену важећу у тренутку наплате захтева и провери тренутни ценовник пре него што утврди буџет.

Подесите пројекат и кључ

Runway-ов водич за подешавање каже да треба направити налог и пројекат на порталу за програмере, а затим креирати API кључ пројекта у одељку API Keys. За креирање или деактивирање кључа потребна је улога Admin или Developer. Кључ се приказује у обичном тексту само једном, зато га безбедно сачувајте. За употребу SDK-а, Runway каже да подесите RUNWAYML_API_SECRET; SDK аутоматски чита ту променљиву. Не стављајте тајну у изворни код.

Пројекту су потребни и кредити пре коришћења API-ја. Runway наводи да је минимална почетна уплата $10, по цени од $0.01 по кредиту, преко картице за наплату пројекта. За додавање кредита потребна је улога Admin или Billing admin. То је минимална куповина кредита, а не цена једног говорног захтева. Страница за подешавање не описује бесплатан први позив.

Пошаљите захтев за претварање текста у говор

Тренутни тип захтева у Runway Python SDK-у захтева model, prompt_text и објекат voice за Eleven v4. У JSON захтеву одговарајућа поља су model, promptText и voice, при чему је voice.type подешен на runway-preset и један објекат presetId. Bernard је један од наведених унапред подешених гласова. SDK сервис шаље овај захтев на /v1/text_to_speech и враћа одговор са новим задатком. Runway-ов API водич документује хост, bearer кључ и заглавље X-Runway-Version: 2024-11-06 који се користе за директне HTTP позиве.

Ово је тело захтева изведено из документације, а не позив који смо извршили:

{
  "model": "eleven_v4",
  "promptText": "The recording begins now. [pause] Welcome.",
  "voice": {
    "type": "runway-preset",
    "presetId": "Bernard"
  }
}

Runway-ов унос у дневник измена од 30. септембра наводи [laughs], [whispers] и [pause] као подржане примере и каже да Eleven v4 користи исте Runway унапред подешене гласове као Eleven v3. Ознаке су део скрипте; оставите места за њих у оквиру наведеног максимума од 2.500 знакова. SDK наводи и опционална подешавања гласа, језик и суседна текстуална поља. Његова шема не потврђује да било које подешавање гарантује одређен начин изговора, а овај чланак не износи тврдње о квалитету гласа или кашњењу.

Почетни одговор је задатак, а не аудио-подаци. Runway-ов водич за излаз каже да треба упутити упит GET /v1/tasks/:id; успешно завршен задатак садржи низ output URL-ова резултата. Ти URL-ови истичу 24–48 сати након приступа API-ју, зато преузмите резултат у сопствено складиште уместо да користите привремени URL у производу. Општи пример излаза приказује видео-задатак; он показује структуру одговора задатка, док списак модела означава да је излаз Eleven v4 аудио. Нисмо видели одговор Eleven v4 нити проверили формат његове аудио-датотеке.

Израчунајте цену према датуму

Runway-ова страница са ценама и белешка о издању наводе 2,2 кредита за 1.000 знакова до 12. октобра 2026. по пацифичком времену, затим 5 кредита за 1.000 знакова, уз минимум од једног кредита. По објављеној цени од $0.01 по кредиту, те цене износе $0.022 и $0.05 за 1.000 знакова пре евентуалног пореза. Каснија наведена цена је око 2,27 пута већа од раније.

Јасан пример за планирање: десет засебних скрипти са тачно 1.000 знакова који се наплаћују у свакој имало би укупно 10.000 знакова. Множењем са објављеним ценама добија се 22 кредита, односно $0.22, по ранијој цени и 50 кредита, односно $0.50, по каснијој цени. Свака скрипта је краћа од ограничења од 2.500 знакова, а сваки израчунати захтев премашује минимум од једног кредита. Ово је рачуница заснована на ценама које је објавио Runway, а не стварно примљен рачун. Наведене странице не објашњавају како се ознаке рачунају у наплативе знакове нити да ли се делимичне цене по захтеву заокружују, па би процена у продукцији требало да провери стварне евиденције коришћења и важеће услове.

Извори и додатно читање

Runway-ов API дневник измена од 30. септембра потврђује датум издања, ID модела, примере ознака, ограничење скрипте и ценовну изјаву са датумом. Водич за подешавање објашњава предуслове за пројекат, кључ и кредите, укључујући дозволе улога и почетну уплату од $10. Страница са ценама садржи конверзију кредита у доларе и наведене цене за Eleven v4.

Документација шеме захтева Python SDK-а и имплементације сервиса потврђује називе поља, структуру унапред подешеног гласа, путању крајње тачке и одговор при креирању задатка који су проверени за овај водич. Runway-ови водич за почетак, списак модела и водич за излаз дају HTTP заглавље верзије, класификацију аудио-излаза и понашање преузимања задатка. То су документи добављача, а не независно испитивање перформанси. Проверено 6. октобра 2026.