跳转到内容

Дыбыс, бейне және дауыстар

Медиа жұмыс құрылған бойда іске қосылады және сервер өлшейтін пайдалану көлеміне сәйкес кредит бағасымен есептеледі. Алдымен каталогты оқып шығыңыз; тек ашық деп белгіленген өнімдерді ғана іске қосуға болады.

Бағалар тікелей несиелермен көрсетілген:

ӨнімproductБаға
Дауыс тануasr20 кредит/минут; fun-asr нақты уақыттағы модель 30 кредит/минут (миллисекундпен есептеледі)
Тақырып астының аудармасыsubtitle_translation60 кредит/минута
Негізгі бейне өңдеу (аударылған субтитрлер, түпнұсқа дыбыс)basic_video80 кредит/минута
Толық бейне өңдеу (аударылған субтитрлер мен дубляж)full_video300 кредит/минут
Дыбыс жасауtts10 000 есептелетін таңбадан 1500 кредит
Дауысты алғаш рет сәтті қолдану—Әр дауыс үшін 300 кредит, бір рет алынады
  • Сөйлеуді тану қолданылатын тану моделіне байланысты бағаланады; екі модельдің де бағасы credit-catalog-тегі prices (яғни model өрісі) арнайы тізімделген.
  • Ұзақтық миллисекундтармен есептеледі: дауысты тану және субтитрлерді аудару шығу дерегінің ұзақтығы бойынша, ал бейне — жеткізілген бейненің ұзақтығы бойынша.
  • Дыбыс құрастыру үшін есептелетін таңбалар: әрбір қытай иероглифі 2-ге тең, ал басқа барлық таңбалар (бос орындар мен тыныс белгілерді қоса алғанда) 1-ге тең.
  • Өнімге қажетті тану, аударма, дубляж және басқа да қадамдар бағасына кіреді. Егер сұраныс төменгі деңгейдегі нәтиже (allowed_fallback_products) беруге мүмкіндік берсе және ол жеткізілсе, онда жеткізілген өнімнің бағасы қолданылады.
  • Құны = бірлік бағасы × пайдалану, 0,001 кредитке дейін (1 милликредит) дөңгелектеледі.
GET /api/v1/billing/media/credit-catalog
POST /api/v1/billing/media/credit-estimates

credit-catalog әрбір өнімнің бағасын (prices, милликредиттерде) және оның ашық екенін қайтарады; credit-estimates берілген ұзақтық, мәтін немесе дауыс саны үшін қажетті кредиттерді (rounded_millicredits) есептейді. Бұл тек көрсету үшін: ол жұмыс жасамайды және ешқандай ақы алмайды.

POST /api/v1/media-jobs
Idempotency-Key: unique-request-id

Өнімдер:

productМақсат
asrДауыс тану
ttsДыбыс жасау
subtitle_translationАудио мен бейненің астыңғы жазбасын аудару
basic_videoНегізгі бейне өңдеу
full_videoТолық бейне өңдеу

Сөйлеуді тану мысалы:

{
"product": "asr",
"document_id": "4q8mx2q9z1k7p6ra",
"source_language": "auto",
"max_duration_ms": 600000
}

Сөйлеуді синтездеу (tts)-ден басқа барлық өнім max_duration_ms (миллисекунд, ең көбі 21600000, яғни 6 сағат) талап етеді.

Жасау сұранымы 202 нәтижесін берген соң, сервер файлды тексереді және өңдеуді бастайды:

  1. Басталар алдында тек баланс тексеріледі : баланс (қарыздан кейін) сервер өлшеген ұзақтықтан есептелген шығыннан жоғары болуы тиіс (сөйлеуді синтездегенде, есептелген символдардан, соның ішінде әлі алынбаған алғашқы пайдалану дауысы үшін төлемнен); бюджеті бар API кілті болса, кілттің қалған бюджеті де осы шығыннан жоғары болуы керек. Бастау балансқа әсер етпейді.
  2. Нақты пайдалану аяқталған кезде төленеді : жеткізілген өнім мен пайдалану бойынша бағаланады және төленеді. Баланс қамтымайтын сома қарыз ретінде есепке алынады және баланс теріс мәнге ие болады; кейіннен түсетін несиелер алдымен осы қарызды жабады. Баланс теріс болған кезде жаңа жұмыстар бастала алмайды.
  3. Сәтсіз аяқталған немесе тоқтатылған тапсырмалар үшін ақы алынбайды.

Баланс тым аз немесе ұзақтығы сәйкес келмеген жағдайда, ештеңе басталмайды және ештеңе төленбейді: дауыстық синтез жасау жасалған кезде тексеріледі және баланс тым аз болғанда 402 мәнін қайтарады; басқа өнімдер сервер ұзақтықты өлшегеннен кейін тексеріледі және тапсырма error_code insufficient_credits (баланс тым аз) немесе media_duration_exceeds_confirmed_cap (нақты ұзақтық max_duration_ms-ден асады) кодтарымен сәтсіздікке ұшырайды.

GET /api/v1/media-jobs/{operation_id}
GET /api/v1/media-jobs?limit=25
POST /api/v1/media-jobs/{operation_id}/cancel

Сұрау жауабында тапсырманың мәртебесі, жеткізілген файлдар және есеп айырысу сілтемесі көрсетіледі.

GET /api/v1/media-voices
POST /api/v1/media-voices
GET /api/v1/media-voices/{asset_id}
POST /api/v1/media-voices/{asset_id}/confirm
POST /api/v1/media-voices/{asset_id}/reconcile
POST /api/v1/media-voices/{asset_id}/revoke

reconcile белгісіз қашықтық нәтижесін қалпына келтіреді; ол тек бастапқы операцияны тексереді және екінші дауысты ешқашан жасамайды.

Дауыс жасау үшін жазбаға қатысты құқықтарыңызды растау қажет:

{
"document_id": "authorized_recording_document_id",
"consent": true,
"consent_version": "voice-source-rights-v1"
}

Қоңырау шалушы жазбаның өзінікі екеніне немесе заңды рұқсатпен пайдаланылып жатқанына көз жеткізуге міндетті.