Ir para o conteúdo

Configurar serviços de modelos

Escolha como pagar pelos serviços de IA, configure a conexão e verifique sem gerar mídia.

Você precisa de um serviço de modelos?

Recortar e organizar vídeos existentes, editar legendas existentes e exportar localmente não exige chave de modelo de geração. Análise de vídeo, transcrição de fala e geração de imagens, vídeos ou áudio exigem o serviço correspondente. Configure apenas os serviços necessários à sua tarefa.

1. Escolha a forma de cobrança

Com uma conta própria de provedor, a cobrança vai para essa conta. Em uma conexão oficial do rikoko, use apenas o endereço do serviço e a chave pessoal de API realmente fornecidos a você; confira a disponibilidade e os créditos da sua conta. Login do site, chave pessoal de API do rikoko, chave do provedor e chave do espaço de trabalho local têm funções diferentes. Não troque uma pela outra.

O web app usa a conta na nuvem e os serviços configurados pelo operador. Alterar os arquivos do MCP local não configura o web app. Um modelo exibido em qualquer interface não garante que esteja habilitado para sua conta.

2. Localize a configuração ativa

Em uma instalação gerenciada, encontre o arquivo installation.json indicado por VIDEOWORKBENCH_MANAGED_CONFIG na entrada MCP do rikoko no cliente. O campo home identifica o diretório de instalação. Os caminhos abaixo são relativos a ele. Instalações pelo código-fonte ou em servidor próprio podem usar outro caminho; confira a configuração de inicialização.

ArquivoO que colocar aqui
config/models.jsonModo de conexão, adaptadores, perfis de modelos e limites de entrada/custo. Sem valores de chaves secretas.
config/credentials.jsonValores privados das chaves, associados ao nome exato de keyEnv em models.json. Insira os segredos localmente, não no chat.
data/server.logDiagnóstico de inicialização e conexão. Remova segredos antes de compartilhar trechos.

3. Configure um perfil compatível

Para usar sua própria conta de provedor, copie este pedido e informe ao agente qual provedor você usa. Ele pode localizar os arquivos e preparar a configuração com você. Para uma conexão oficial, peça que use o endereço de serviço fornecido a você. Os detalhes de configuração manual estão após o pedido.

Pedido
Ajude a configurar os serviços de IA na minha instalação existente do rikoko. Primeiro identifique a versão, os arquivos ativos e a forma de cobrança sem exibir segredos. Quero usar meu próprio provedor para gerar vídeos, de preferência com um perfil MiniMax compatível. Confira o perfil da versão, o suporte a referências e o preço atual antes de propor mudanças. Preserve as outras conexões. Informe onde inserir a chave de forma privada. Não habilite a execução paga nem envie tarefas até eu aprovar a configuração e o orçamento.

Para um provedor próprio, models.json usa schemaVersion: 1, mode: "custom" e um array providers. Cada conexão contém id, adapter, keyEnv, enabled e models. Os adaptadores aceitos são fal, fal-video, replicate e gemini. Cada perfil exige endpoint exato, kind, parameters, priceVersion, maxCostCents e hardBoundConfirmed; modelos com referências também exigem os vínculos de entrada corretos. Só a marca do modelo ou a chave de API não basta.

Peça ao agente para inspecionar um perfil compatível da versão instalada e verificar endpoint, limites de entrada e preço atual do provedor. Não estime custos sem base nem marque hardBoundConfirmed como true antes de verificar o limite de custo. Mantenha enabled como false durante a preparação. Salve a credencial de forma privada sob o nome de keyEnv correspondente; no macOS/Linux, o arquivo deve permanecer acessível apenas ao proprietário (0600). Faça backup da configuração e preserve as outras conexões.

Para uma conexão oficial fornecida, use mode: "official", official.url com a origem do serviço informado e official.keyEnv com o nome da credencial. Não invente uma URL de nuvem nem reutilize uma chave de provedor. Se você não recebeu endereço e chave oficiais, use um provedor próprio compatível ou continue editando localmente.

4. Aplique e verifique

Depois de revisar o perfil e o limite de gastos, habilite a conexão escolhida. Conclua as tarefas ativas, reinicie o serviço local pelo procedimento da sua instalação e reconecte o cliente. Recarregar apenas o chat não atualiza a configuração de um backend em execução. Peça uma consulta de capabilities e generation_usage, sem geração.

Pedido
Consulte capabilities e generation_usage do rikoko. Informe a origem da cobrança, os IDs exatos dos modelos, a disponibilidade, as referências aceitas e as configurações de saída. Explique o que falta configurar. Não analise mídia nem gere nada.

A consulta deve identificar o modelo e a forma de cobrança esperados. Ela não testa o saldo do provedor nem a qualidade real do resultado. Se um modelo estiver indisponível, confira enabled, o nome da credencial, a validação do perfil e a confirmação do custo. Se o catálogo continuar antigo, confira a instalação ativa e reinicie. O primeiro teste pago é uma etapa separada, com orçamento combinado.

Catálogo de modelos e configurações de entrada →

Solução de problemas em detalhes →

Guia para o rikoko 0.1.32, revisado em 22 de outubro de 2026. Consulte os modelos disponíveis no serviço que você conectou.