Абжьы/Адиаризациа, аиҭага, аклонра & авидео
Адиаризациа, аиҭага, аклонра & авидео
v1.0.x · ирҿыцуп 2026-06-26
Абжьы аҩныҟатәи адәныҟатәи аан, AiHummer иаҭоит ԥшьба
иҵегь, опт-ин медиа-лшарақәа: абжьыҟаҵаҩ адиаризациа, абжьы
аиҭага, абжьы аклонра ацны авидео аилкаара. Иаауазаалак иауеит
иаофлайн иарада/алокалу адвигательқәа рҿы асайдкар ҳасабла
URL ала иаулано.
[!NOTE]
Ари иарбоу / асайдкар алшарақәоуп, SIP алшарақәа мап. SIP аканал ахаҭа
иадгылоит STT, TTS, barge-in, DTMF ацны аҭагалара мацара — адиаризациа, аиҭага
ацны абжьы аклонра иарбоу абжьы иарбоуп, /v1/voice/* аҿы иаарԥшу.
Абжьыҟаҵаҩ адиаризациа
Адиаризациа иҭакуеит “иарбан ицәажәоз ианба” акырынтә абжьыҟаҵаҩ змоу аудио-клип аҿы. Уи
иауеит pyannote speaker-diarization-3.1, иаофлайн, diarize сайдкар аҿы.
| Аҭем |
Иаԥхьаӡара |
| Адвигатель |
pyannote speaker-diarization-3.1 (иаофлайн) |
| Асайдкар апорт |
:8003 |
| Эндпоинт |
POST /v1/voice/diarize |
| Иавироу |
AIHUMMER_DIARIZE_URL |
Абжьы аиҭага
Аиҭага абжьы (ма уи атранскрипт) акыбызшәа аҟынтә егьи ахь иаиҭанагоит уи
аагент ахьаԥшахаара иуланаху бызшәа ала имаҵура иуртә.
| Аҭем |
Иаԥхьаӡара |
| Эндпоинт |
POST /v1/voice/translate |
Абжьы аклонра
Абжьы аклонра абжьы исинтезируеит иаалоу абжьы аҿы. Уи иауеит OpenVoice V2
MeloTTS ацны — иаофлайн насгьы MIT-лицензиа змоу — voiceclone сайдкар аҿы.
| Аҭем |
Иаԥхьаӡара |
| Адвигатель |
OpenVoice V2 + MeloTTS (иаофлайн, MIT) |
| Асайдкар апорт |
:8004 |
| Эндпоинт |
POST /v1/voice/clone |
| Иавироу |
AIHUMMER_VOICECLONE_URL |
Авидео аилкаара
Авидео аилкаара иҵнахуеит аклип иаанакыло аудио адемуксра ацны акейфреймқәа арыхәԥкаара
ffmpeg ала — ари асайдкар аҿы ML-модель ыҟам; уи иаԥхиаркуеит
аудиои акадрқәеи аагент ахаҿ азы.
| Аҭем |
Иаԥхьаӡара |
| Иадгылоу |
ffmpeg (демукс + акейфреймқәа, ML ада) |
| Асайдкар апорт |
:8005 |
| Эндпоинт |
POST /v1/video/understand |
| Иавироу |
AIHUMMER_VIDEO_URL |
Авиринг
Иаауазаалак алшара иаактивтахоит уи асайдкар URL аиқәыршәоу аамҭазы мацара. Хост-натив
аинсталлер ари иауаԥҟартә алшоит, ма уара иуаауазаалак аинстансқәа ахь иарбоит.
# gateway.env — optional voice/video sidecars
AIHUMMER_DIARIZE_URL=http://127.0.0.1:8003
AIHUMMER_VOICECLONE_URL=http://127.0.0.1:8004
AIHUMMER_VIDEO_URL=http://127.0.0.1:8005
[!TIP]
Ари асайдкарқәа ихазхаҭоуп — иуланаху мацара иаунакыр. Атранскрипциеи асинтези
мацара иаԥхьаԥшы адеплоймент STT/TTS ҩаԥхьа мацара иауеит насгьы diarize, voiceclone
авидеои иаԥырмҵаны иаанха.
Аҩаџьара иуцо
[Абжьы аҩныҟатәи адәныҟатәи](/ab/v1.0/voice/stt-tts) аан, AiHummer иаҭоит ԥшьба
иҵегь, опт-ин медиа-лшарақәа: **абжьыҟаҵаҩ адиаризациа**, **абжьы
аиҭага**, **абжьы аклонра** ацны **авидео аилкаара**. Иаауазаалак иауеит
**иаофлайн иарада/алокалу адвигательқәа рҿы** [асайдкар](/ab/v1.0/architecture/sidecars) ҳасабла
URL ала иаулано.
> [!NOTE]
> Ари **иарбоу / асайдкар алшарақәоуп**, SIP алшарақәа мап. SIP аканал ахаҭа
> иадгылоит STT, TTS, barge-in, DTMF ацны аҭагалара мацара — адиаризациа, аиҭага
> ацны абжьы аклонра иарбоу абжьы иарбоуп, `/v1/voice/*` аҿы иаарԥшу.
## Абжьыҟаҵаҩ адиаризациа
Адиаризациа иҭакуеит "иарбан ицәажәоз ианба" акырынтә абжьыҟаҵаҩ змоу аудио-клип аҿы. Уи
иауеит **pyannote `speaker-diarization-3.1`**, иаофлайн, diarize сайдкар аҿы.
| Аҭем | Иаԥхьаӡара |
|---|---|
| Адвигатель | pyannote `speaker-diarization-3.1` (иаофлайн) |
| Асайдкар апорт | `:8003` |
| Эндпоинт | `POST /v1/voice/diarize` |
| Иавироу | `AIHUMMER_DIARIZE_URL` |
## Абжьы аиҭага
Аиҭага абжьы (ма уи атранскрипт) акыбызшәа аҟынтә егьи ахь иаиҭанагоит уи
аагент ахьаԥшахаара иуланаху бызшәа ала имаҵура иуртә.
| Аҭем | Иаԥхьаӡара |
|---|---|
| Эндпоинт | `POST /v1/voice/translate` |
## Абжьы аклонра
Абжьы аклонра абжьы исинтезируеит иаалоу абжьы аҿы. Уи иауеит **OpenVoice V2
MeloTTS ацны** — иаофлайн насгьы **MIT-лицензиа змоу** — voiceclone сайдкар аҿы.
| Аҭем | Иаԥхьаӡара |
|---|---|
| Адвигатель | OpenVoice V2 + MeloTTS (иаофлайн, MIT) |
| Асайдкар апорт | `:8004` |
| Эндпоинт | `POST /v1/voice/clone` |
| Иавироу | `AIHUMMER_VOICECLONE_URL` |
## Авидео аилкаара
Авидео аилкаара иҵнахуеит аклип иаанакыло аудио адемуксра ацны акейфреймқәа арыхәԥкаара
**ffmpeg** ала — ари асайдкар аҿы **ML-модель ыҟам**; уи иаԥхиаркуеит
аудиои акадрқәеи аагент ахаҿ азы.
| Аҭем | Иаԥхьаӡара |
|---|---|
| Иадгылоу | ffmpeg (демукс + акейфреймқәа, ML ада) |
| Асайдкар апорт | `:8005` |
| Эндпоинт | `POST /v1/video/understand` |
| Иавироу | `AIHUMMER_VIDEO_URL` |
## Авиринг
Иаауазаалак алшара иаактивтахоит уи асайдкар URL аиқәыршәоу аамҭазы мацара. Хост-натив
аинсталлер ари иауаԥҟартә алшоит, ма уара иуаауазаалак аинстансқәа ахь иарбоит.
```ini
# gateway.env — optional voice/video sidecars
AIHUMMER_DIARIZE_URL=http://127.0.0.1:8003
AIHUMMER_VOICECLONE_URL=http://127.0.0.1:8004
AIHUMMER_VIDEO_URL=http://127.0.0.1:8005
```
> [!TIP]
> Ари асайдкарқәа ихазхаҭоуп — иуланаху мацара иаунакыр. Атранскрипциеи асинтези
> мацара иаԥхьаԥшы адеплоймент STT/TTS ҩаԥхьа мацара иауеит насгьы diarize, voiceclone
> авидеои иаԥырмҵаны иаанха.
## Аҩаџьара иуцо
- Адефолт абжьы апаҭ:
[Абжьы аҩныҟатәи адәныҟатәи](/ab/v1.0/voice/stt-tts).
- Асайдкарқәа ишԥавироу ацны ишԥажәларо:
[Асайдкарқәа](/ab/v1.0/architecture/sidecars).