Установите плагины FishAudio TTS 文字转语音 и Media Sync в Coze и используйте собственный API Key для генерации речи и синхронизированного видео.

Использование FishAudio в Coze

FishAudio предлагает два плагина в магазине Coze. Рекомендуется установить плагины; прямую настройку HTTP используйте только для нестандартных запросов.

Плагин	Назначение	Установка
FishAudio TTS 文字转语音	Преобразовать текст в речь и вернуть URL аудио	Открыть в Coze
FishAudio 图片/视频对口型	Создать асинхронную задачу из URL видео и аудио	Открыть в Coze

Подготовка API Key

Создайте отдельный ключ для Coze на странице управления API и проверьте API-кредиты. Передавайте ключ так:

Authorization: Bearer YOUR_FISH_AUDIO_API_KEY

После Bearer нужен один пробел. Каждый клиент использует собственный ключ, а расход относится к его аккаунту Fish Audio.

Создание собственного приватного плагина

Если плагины магазина не подходят, скачайте FishAudio TTS 文字转语音 OpenAPI, FishAudio 图片/视频对口型 OpenAPI, FishAudio 文字对口型 OpenAPI или FishAudio 专属语音合成 OpenAPI и импортируйте файл в Coze как облачный плагин на основе существующего сервиса. Выберите отсутствие авторизации и передавайте клиентский Authorization во время выполнения. Подробности приведены в английской инструкции.

Рекомендуется использовать кнопку Import справа вверху: в этом варианте нужен только OpenAPI YAML. Если слева показано ai_plugin (JSON), а справа openapi (YAML), вы находитесь на странице создания через код </>. Не оставляйте ai_plugin пустым: вставьте слева соответствующий *.ai-plugin.json, а справа — *.openapi.yaml с тем же префиксом. manifest.json — это только перечень файлов пакета FishAudio, а не файл ai_plugin.

Текущая доступность: FishAudio TTS 文字转语音 и FishAudio 图片/视频对口型 доступны в магазине; FishAudio 文字对口型 и FishAudio 专属语音合成 предоставляются только как приватные плагины для импорта.

Использование FishAudio TTS 文字转语音

Добавьте FishAudio TTS 文字转语音 в свое пространство Coze.
Добавьте инструмент TTS в агента или процесс.
Укажите Authorization, текст, Voice ID и дополнительные параметры.
Подключите полученный audio_url к воспроизведению, загрузке или Media Sync.

Сначала проверьте короткое предложение. Voice ID должен относиться к действительному системному или доступному этому аккаунту пользовательскому голосу.

Использование FishAudio 图片/视频对口型

FishAudio 图片/视频对口型 содержит два инструмента:

Инструмент	Назначение
`create_media_sync`	Создать задачу из напрямую загружаемых URL видео и аудио
`get_media_sync_job`	Получить прогресс, результат или ошибку по `jobId`

Передайте Authorization, video_url и audio_url в create_media_sync. Сохраните data.id и используйте его как jobId. Создание задачи расходует API-кредиты.

processing: подождите и снова запросите тот же jobId.
completed: прочитайте data.result_url.
failed: прочитайте data.error_message.

Не запускайте create_media_sync повторно из-за тайм-аута или продолжающейся обработки. Это может создать и списать средства за дубликат.

Процесс от текста до синхронизированного видео

Можно связать два плагина магазина по схеме ниже или импортировать приватный FishAudio 文字对口型, который объединяет TTS и синхронизацию губ в одной операции создания:

Текст + Voice ID → FishAudio TTS 文字转语音 → audio_url
URL видео + audio_url → create_media_sync → data.id
Сохранить jobId → ждать 15–30 с → get_media_sync_job
completed: data.result_url | failed: data.error_message

Для автоматического опроса задайте максимум запросов и общий тайм-аут.

Приватный плагин вызывает create_text_lip_sync, затем get_text_lip_sync_job. Для каждой новой задачи используйте новый Idempotency-Key; повторяйте исходное значение только при повторной отправке полностью идентичного запроса.

URL медиа и безопасность ключа

Fish Audio должен иметь возможность напрямую скачать видео и аудио. Веб-страницы, локальные пути и просроченные подписанные URL не подходят. Временный URL Coze должен действовать до завершения загрузки.

Authorization может появиться в диалогах, отладке или журналах Coze. Создайте отдельный ключ Coze, не делитесь снимками или шаблонами с реальным ключом и меняйте либо отзывайте тестовые ключи. Не встраивайте общий ключ в публичный плагин.

Устранение неполадок

401: проверьте Bearer , лишние пробелы и действительность ключа.
402: проверьте API-кредиты; они отделены от кредитов подписки.
Ошибка загрузки медиа: проверьте прямой доступ и срок URL.
Статус processing: запрашивайте тот же jobId, не создавайте новую задачу.
Ключ виден в журнале: отзовите его и создайте новый ключ Coze.

Дополнительно: прямой вызов TTS HTTP API

HTTP-узел Coze может вызвать POST https://fishaudio.org/v1/audio/speech с Authorization и Content-Type: application/json. Передайте model, voice, input и response_format: "mp3"; настройте ответ как файл или двоичные данные, а не JSON.

Настройка Coze