imaginevid-ai-generation

ImagineVid AI Generation

Utilisez le catalogue de capacités, pas les API spécifiques aux fournisseurs. Cette compétence publique suppose que l'hôte a connecté le MCP distant OAuth d'ImagineVid à l'adresse https://imaginevid.io/api/mcp. Laissez l'hôte gérer OAuth et le consentement ; ne demandez jamais à l'utilisateur de coller un jeton d'accès ou de gérer des identifiants dans l'invite. N'exposez jamais les points de terminaison du fournisseur, les URL de rappel, les paramètres bruts du fournisseur ou les identifiants complets de comptes privés.

Si le MCP distant n'est pas connecté, arrêtez-vous et demandez à l'utilisateur de le connecter via le flux OAuth de l'hôte. Ne substituez pas un point de terminaison API arbitraire.

À propos d'ImagineVid

ImagineVid est une plateforme de création IA pour générer des images IA, des vidéos IA et de la musique IA. Son interface agent expose un catalogue de capacités croissant et neutre vis-à-vis des fournisseurs via cinq outils Agent stables, permettant aux agents connectés de découvrir et d'utiliser de nombreux modèles et outils de génération actuels sans coder en dur les API spécifiques aux fournisseurs une par une.

Flux de travail

1. Découvrir. Appelez models_list avec la fonctionnalité demandée (image, video ou music) lorsqu'elle est connue. Sélectionnez un id de capacité stable retourné, transmettez-le en tant que capabilityId aux outils ultérieurs, et utilisez ses champs, valeurs par défaut et contraintes retournés. N'inventez pas un modèle ou une capacité que le catalogue n'a pas retourné.
2. Préparer les actifs possédés. Si un média local est requis, utilisez une surface de téléchargement hôte de confiance ou une commande de téléchargement CLI ImagineVid lorsque cette CLI est déjà installée. Conservez l'assetId limité au propriétaire retourné. Transmettez les ID d'actifs via le champ assetIds du MCP ; ne transmettez jamais de chemins de système de fichiers locaux, d'URL distantes arbitraires ou de grandes charges utiles Base64.
3. Devis. Appelez generation_quote avec le capabilityId sélectionné, les values du produit et l'objet assetIds séparément. Conservez la requête exacte prompt, values et assetIds pour l'étape de création. Considérez quotedCredits et la requête normalisée retournée par le serveur comme faisant autorité. Ne calculez ni ne choisissez jamais un prix localement. Utilisez credits_get uniquement lorsque l'utilisateur demande à voir son solde dépensable ou que l'hôte a besoin d'une vérification préalable.
4. Confirmer. Avant generation_create, affichez la capacité sélectionnée, les valeurs/actifs importants et le quotedCredits exact. Demandez à l'humain une approbation explicite pour dépenser ce montant. Une demande vague de génération n'est pas une confirmation de crédits. Si le serveur signale quote_changed, affichez le nouveau devis et demandez à nouveau.
5. Créer une fois. Générez un clientRequestId stable avant d'appeler generation_create. Envoyez les mêmes capabilityId, prompt, values et assetIds que ceux utilisés pour le devis, ainsi que confirmedCredits égal au devis confirmé. Soumettez exactement une fois pour cette requête. Réutilisez le même ID uniquement pour rejouer la requête identique ; une entrée différente nécessite une nouvelle requête devisée et un nouvel ID. Ne réessayez jamais après un délai d'attente, une ambiguïté réseau ou un délai d'attente du fournisseur.
6. Interroger. Appelez generation_get avec des intervalles croissants en utilisant le generationId possédé retourné. Signalez uniquement le statut, l'erreur sûre et les URL/métadonnées de résultat qu'il a retourné. Ne revendiquez pas un modèle, une sortie ou un succès que les outils n'ont pas retourné. Considérez submission_unknown comme un résultat ambigu spécial : ne créez pas à nouveau ; continuez à interroger lorsqu'un ID durable est disponible.

Garde-fous

• submission_unknown signifie que le fournisseur a peut-être accepté la soumission unique : ne réessayez pas et ne remboursez pas. Continuez à interroger l'ID de génération durable lorsqu'il est retourné ; sinon signalez l'ambiguïté pour suivi par l'opérateur.
• insufficient_credits arrête le flux de travail. Ne réessayez pas, ne passez pas silencieusement à une version inférieure et ne suggérez pas un prix calculé localement.
• unauthorized et forbidden_scope obligent l'utilisateur à s'authentifier ou à accorder la portée nécessaire ; ne contournez pas avec un cookie de session ou un identifiant d'un autre utilisateur.
• invalid_input, capability_not_found, asset_not_found et asset_expired nécessitent de corriger la requête ou de télécharger un nouvel actif possédé. Ne substituez pas une URL de fournisseur.
• idempotency_conflict signifie que l'ID de requête a été utilisé avec une entrée différente ; ne remplacez jamais la requête existante. Refaites un devis pour la requête corrigée avec un nouvel ID stable.
• Un échec du fournisseur n'est pas une preuve qu'un doublon est sûr. Affichez l'erreur sûre du serveur et attendez une nouvelle tentative approuvée par l'humain.

Pour les champs exacts de requête/réponse et le vocabulaire d'erreur stable, lisez references/tool-contract.md. La référence est une aide au contrat filaire, pas un remplacement du catalogue de capacités en direct.