Instale os plugins FishAudio TTS 文字转语音 e Media Sync no Coze e use sua própria API Key para gerar voz e vídeos sincronizados.

Usar FishAudio no Coze

O FishAudio oferece dois plugins na loja do Coze. Instalar os plugins é o método recomendado; use a configuração HTTP direta apenas para solicitações personalizadas.

Plugin	Finalidade	Instalação
FishAudio TTS 文字转语音	Converter texto em voz e retornar uma URL de áudio	Abrir no Coze
FishAudio 图片/视频对口型	Criar uma tarefa assíncrona com URLs de vídeo e áudio	Abrir no Coze

Preparar uma API Key

Crie uma chave exclusiva para o Coze na página de gerenciamento da API e confira seus créditos de API. Use este formato:

Authorization: Bearer YOUR_FISH_AUDIO_API_KEY

Deve existir um espaço depois de Bearer. Cada cliente usa sua própria chave, e o consumo é cobrado da respectiva conta Fish Audio.

Criar um plugin privado

Se não quiser usar os plugins da loja, baixe FishAudio TTS 文字转语音 OpenAPI, FishAudio 图片/视频对口型 OpenAPI, FishAudio 文字对口型 OpenAPI ou FishAudio 专属语音合成 OpenAPI e importe no Coze como um plugin de nuvem baseado em serviço existente. Selecione sem autorização e informe o Authorization do cliente em tempo de execução. Consulte o guia em inglês.

Recomendamos usar Importar no canto superior direito; esse caminho exige apenas o YAML OpenAPI. Se aparecer ai_plugin (JSON) à esquerda e openapi (YAML) à direita, você está na página de criação por código </>. Não deixe ai_plugin vazio: cole o *.ai-plugin.json correspondente à esquerda e o *.openapi.yaml com o mesmo prefixo à direita. manifest.json é apenas o inventário do pacote FishAudio e não deve ser usado como ai_plugin.

Disponibilidade atual: FishAudio TTS 文字转语音 e FishAudio 图片/视频对口型 estão na loja; FishAudio 文字对口型 e FishAudio 专属语音合成 são oferecidos apenas como plugins privados para importação.

Usar FishAudio TTS 文字转语音

Adicione FishAudio TTS 文字转语音 ao seu espaço no Coze.
Adicione a ferramenta TTS a um agente ou fluxo de trabalho.
Informe Authorization, texto, Voice ID e controles opcionais.
Conecte o audio_url retornado à reprodução, download ou Media Sync.

Teste primeiro com uma frase curta. O Voice ID deve ser uma voz de sistema válida ou uma voz personalizada disponível na conta atual.

Usar FishAudio 图片/视频对口型

FishAudio 图片/视频对口型 contém duas ferramentas:

Ferramenta	Finalidade
`create_media_sync`	Criar tarefa com URLs de vídeo e áudio diretamente baixáveis
`get_media_sync_job`	Consultar progresso, resultado ou erro pelo `jobId`

Envie Authorization, video_url e audio_url para create_media_sync. Salve data.id e use-o como jobId. Criar uma tarefa consome créditos de API.

processing: aguarde e consulte novamente o mesmo jobId.
completed: leia data.result_url.
failed: leia data.error_message.

Não execute create_media_sync novamente por causa de timeout ou enquanto a tarefa estiver processando. Isso pode criar e cobrar uma tarefa duplicada.

Fluxo de texto para vídeo sincronizado

Você pode conectar os dois plugins da loja como abaixo ou importar o plugin privado FishAudio 文字对口型, que combina TTS e sincronização labial em uma única criação:

Texto + Voice ID → FishAudio TTS 文字转语音 → audio_url
URL do vídeo + audio_url → create_media_sync → data.id
Salvar jobId → aguardar 15–30 s → get_media_sync_job
completed: data.result_url | failed: data.error_message

Para polling automático, defina um número máximo de consultas e um timeout total.

O plugin privado usa create_text_lip_sync e depois get_text_lip_sync_job. Use um novo Idempotency-Key para cada nova tarefa e reutilize o valor apenas ao repetir exatamente a mesma solicitação.

URLs de mídia e segurança da chave

O serviço Fish Audio deve conseguir baixar diretamente as URLs de vídeo e áudio. Páginas web, caminhos locais e URLs assinadas expiradas não funcionam. Uma URL temporária do Coze deve continuar válida até o fim do download.

Authorization pode aparecer em conversas, depuração ou logs do Coze. Crie uma chave exclusiva para o Coze, não compartilhe capturas ou modelos com uma chave real e altere ou revogue chaves de teste. Nunca inclua uma chave comum em um plugin público.

Solução de problemas

401: verifique Bearer , espaços extras e validade da chave.
402: verifique créditos de API; são separados dos créditos de assinatura.
Falha no download: confira o acesso direto e o prazo da URL.
Continua processing: consulte o mesmo jobId; não crie outra tarefa.
Chave visível em logs: revogue-a e crie uma nova chave para o Coze.

Avançado: chamar diretamente a API HTTP de TTS

Um nó HTTP do Coze pode chamar POST https://fishaudio.org/v1/audio/speech com Authorization e Content-Type: application/json. Envie model, voice, input e response_format: "mp3"; configure a resposta como arquivo ou binário, não JSON.

Configuração do Coze