ImagineVid - Geração de IA

O que ImagineVid - Geração de IA faz?

Use o catálogo de capacidades, não APIs específicas de provedores. Esta skill pública assume que o host conectou o MCP remoto OAuth do ImagineVid em https://imaginevid.io/api/mcp. Deixe o host lidar com OAuth e consentimento; nunca peça ao usuário para colar um token de acesso ou lidar com credenciais no prompt. Nunca exponha endpoints de provedores, URLs de callback, parâmetros brutos de provedores ou identificadores completos de contas privadas.

Se o MCP remoto não estiver conectado, pare e peça ao usuário para conectá-lo através do fluxo OAuth do host. Não substitua por um endpoint de API arbitrário.

Sobre o ImagineVid

ImagineVid é uma plataforma de criação de IA para gerar imagens, vídeos e música com IA. Sua interface de agente expõe um catálogo crescente e neutro de provedores através de cinco ferramentas de agente estáveis, permitindo que agentes conectados descubram e usem muitos modelos e ferramentas de geração atuais sem codificar APIs específicas de provedores uma a uma.

Fluxo de Trabalho

1. Descobrir. Chame models_list com o recurso solicitado (image, video ou music) quando conhecido. Selecione um id de capacidade estável retornado, passe-o como capabilityId para ferramentas posteriores, e use seus campos, padrões e restrições retornados. Não invente um modelo ou capacidade que o catálogo não retornou.
2. Preparar ativos próprios. Se mídia local for necessária, use uma superfície de upload confiável do host ou um comando de upload do ImagineVid CLI quando essa CLI já estiver instalada. Mantenha o assetId de escopo do proprietário retornado. Passe IDs de ativos através do campo assetIds do MCP; nunca passe caminhos de sistema de arquivos locais, URLs remotas arbitrárias ou cargas Base64 grandes.
3. Cotar. Chame generation_quote com o capabilityId selecionado, os values do produto e o objeto assetIds separadamente. Mantenha os exatos prompt, values e assetIds da solicitação para a etapa de criação. Trate quotedCredits e a solicitação normalizada retornada pelo servidor como autoritativos. Nunca calcule ou escolha um preço localmente. Use credits_get apenas quando o usuário pedir para ver seu saldo gastável ou o host precisar de uma verificação prévia.
4. Confirmar. Antes de generation_create, mostre a capacidade selecionada, valores/ativos importantes e o exato quotedCredits. Peça ao humano aprovação explícita para gastar esse valor. Uma solicitação vaga para gerar não é confirmação de crédito. Se o servidor relatar quote_changed, mostre a nova cotação e pergunte novamente.
5. Criar uma vez. Gere um clientRequestId estável antes de chamar generation_create. Envie os mesmos capabilityId, prompt, values e assetIds usados para a cotação, mais confirmedCredits igual à cotação confirmada. Envie exatamente uma vez para essa solicitação. Reuse o mesmo ID apenas para repetir a solicitação idêntica; uma entrada diferente precisa de uma solicitação recém-cotada e um novo ID. Nunca tente novamente após um timeout, ambiguidade de rede ou timeout do provedor.
6. Polling. Chame generation_get com intervalos crescentes usando o generationId de propriedade retornado. Relate apenas o status, erro seguro e URLs/metadados do resultado que ele retornou. Não reivindique um modelo, saída ou sucesso que as ferramentas não retornaram. Trate submission_unknown como um resultado ambíguo especial: não crie novamente; continue fazendo polling quando um ID durável estiver disponível.

Guardrails

• submission_unknown significa que o provedor pode ter aceitado o único envio: não tente novamente e não reembolse. Continue fazendo polling no ID de geração durável quando um for retornado; caso contrário, relate a ambiguidade para acompanhamento do operador.
• insufficient_credits interrompe o fluxo de trabalho. Não tente novamente, degrade silenciosamente ou sugira um preço calculado localmente.
• unauthorized e forbidden_scope exigem que o usuário autentique ou conceda o escopo necessário; não contorne com um cookie de sessão ou credencial de outro usuário.
• invalid_input, capability_not_found, asset_not_found e asset_expired exigem corrigir a solicitação ou enviar um novo ativo próprio. Não substitua por uma URL de provedor.
• idempotency_conflict significa que o ID da solicitação foi usado com entrada diferente; nunca sobrescreva a solicitação existente. Re-cote a solicitação corrigida com um novo ID estável.
• Uma falha de provedor não é prova de que uma duplicata é segura. Exiba o erro seguro do servidor e aguarde uma nova tentativa aprovada pelo humano.

Para campos exatos de solicitação/resposta e o vocabulário estável de erros, leia references/tool-contract.md. A referência é um auxílio de contrato de rede, não um substituto para o catálogo de capacidades ao vivo.