AvataReel
Documentation

AvataReel MCP

Le serveur MCP d'AvataReel permet à votre assistant IA d'utiliser votre compte AvataReel. Il peut choisir des avatars, écrire des scripts, générer des vidéos et acheter des crédits, avec votre accord.

Présentation

MCP (Model Context Protocol) est un standard ouvert qui relie les assistants IA aux applications. AvataReel propose un serveur MCP via HTTP. Vous le connectez une fois avec une clé API personnelle, et votre assistant obtient les mêmes fonctions que vous dans l'app.

Démarrage rapide

  1. 1. Créez une clé API

    Dans AvataReel, ouvrez Paramètres, trouvez "Assistants IA (MCP)", nommez la clé et créez-la. Copiez-la tout de suite : nous ne l'affichons qu'une fois. Ouvrir les Paramètres

  2. 2. Ajoutez le serveur à votre client

    Collez ceci dans la configuration MCP de votre client et remplacez avr_… par votre clé.

    {
      "mcpServers": {
        "avatareel": {
          "type": "http",
          "url": "https://api.avatareel.com/mcp",
          "headers": {
            "Authorization": "Bearer avr_…"
          }
        }
      }
    }

    Dans Claude Code, exécutez :

    claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
  3. 3. Demandez ce dont vous avez besoin

    Demandez avec des mots simples. L'assistant choisit les outils, affiche le prix avant de dépenser des crédits et vous donne le lien de la vidéo quand elle est prête.

Ce que vous pouvez demander

Vous demandezL'assistant
“Fais une pub de 30 secondes pour mon café avec un avatar sympathique.”Liste les avatars, écrit le script, affiche le prix, génère la vidéo et renvoie le lien de téléchargement.
“Écris un script à partir de cette page produit.”Lit la page et rédige un script UGC et une scène.
“Fais trois versions avec des accroches différentes.”Écrit de nouvelles ouvertures et génère une vidéo pour chacune.
“Combien de crédits ai-je ? Achètes-en d'autres.”Affiche votre solde et les offres, puis vous donne un lien de paiement par carte ou un code Pix.
“Crée un avatar à partir de cette photo.”Envoie la photo, crée l'avatar et vous prévient quand il est prêt.
“Résilie mon abonnement.”Lance la résiliation et vous demande avant de confirmer.

Outils

Voici les outils proposés par le serveur. Votre assistant les choisit pour vous ; les noms aident si vous voulez en demander un directement.

Vidéos

Estimer, créer, suivre, relancer et partager des vidéos.

  • quote_video
  • create_video
  • wait_for_video
  • list_videos
  • get_video
  • get_video_steps
  • retry_video
  • delete_video
  • create_videos_from_brief
  • create_hook_variations
  • generate_post_caption
  • create_product_image_upload
  • create_character_swap_upload
  • complete_character_swap_upload
  • create_character_swap_image_upload
  • complete_character_swap_image_upload
  • claim_video_guarantee
  • get_video_feedback
  • send_video_feedback
  • submit_post_link
  • list_listing_images
  • create_listing_images
  • regenerate_listing_image

Scripts

Écrire, réécrire et traduire des scripts, ou partir d'une page produit.

  • list_scripts
  • generate_script
  • generate_guided_script
  • script_from_url
  • rewrite_script
  • translate_script
  • generate_hooks
  • suggest_avatar
  • preview_speech
  • preview_voice
  • generate_batch_scripts

Avatars et voix

Parcourir avatars et voix, ou créer un avatar à partir d'une photo ou d'une description.

  • list_avatars
  • get_avatar
  • list_voices
  • get_avatar_quota
  • create_avatar_photo_upload
  • assess_avatar_photo
  • generate_avatar_face
  • create_avatar
  • confirm_avatar_likeness
  • get_avatar_source_photo
  • replace_avatar_photo
  • set_avatar_voice
  • create_voice_recording_upload
  • merge_voice_takes
  • retry_avatar
  • delete_avatar

Montage

Changer de tenue et de fond, modifier des vidéos terminées et utiliser l'éditeur de mouvement.

  • classify_video
  • check_product_script
  • suggest_wardrobe
  • create_background_upload
  • create_brand_logo_upload
  • create_scene_image_upload
  • preview_appearance
  • change_appearance
  • get_video_captions
  • edit_video
  • get_motion_editor_access
  • create_motion_edit
  • create_automatic_motion_edit
  • get_motion_edit
  • get_video_motion_edit
  • save_motion_edit
  • direct_motion_edit
  • add_motion_soundtrack
  • export_motion_edit

Lots

Créer et télécharger de nombreuses vidéos d'un coup. Nécessite les vidéos en lot sur votre compte.

  • quote_video_batch
  • create_video_batch
  • get_video_batch
  • get_video_batch_download
  • create_batch_motion_edits
  • list_batch_motion_edits

Marque et produits

Kits de marque, logos et photos produit enregistrées.

  • list_brand_kits
  • create_brand_kit
  • brand_kit_from_brief
  • update_brand_kit
  • list_brand_assets
  • generate_brand_asset
  • delete_brand_kit
  • list_product_assets
  • create_product_asset_upload
  • complete_product_asset_upload

Crédits et paiement

Solde, historique, packs de crédits, abonnements, Pix et résiliation.

  • get_credit_balance
  • list_credit_transactions
  • list_unseen_refunds
  • get_billing_offers
  • create_pack_checkout
  • create_pix_charge
  • get_payment_order
  • get_subscription
  • create_subscription_checkout
  • create_subscription_pix
  • get_subscription_pix
  • change_subscription
  • start_subscription_cancel
  • accept_cancel_offer
  • confirm_subscription_cancel
  • create_billing_portal
  • get_billing_profile
  • update_billing_profile

Compte et aide

Profil, suppression du compte et support.

  • get_profile
  • update_profile
  • create_profile_photo_upload
  • delete_account
  • send_support_report
  • ask_support

Crédits et paiement

Les vidéos utilisent les mêmes crédits que l'app. L'assistant demande d'abord un devis et vous montre le prix avant de créer une vidéo.

Quand vous n'avez plus de crédits, l'assistant affiche les packs et abonnements de votre compte. Il vous donne un lien pour payer par carte ou un code Pix à payer dans l'app de votre banque. Les crédits arrivent dès que le paiement est confirmé.

Sécurité

  • Votre clé API agit en votre nom, y compris pour dépenser des crédits. Gardez-la secrète, comme un mot de passe.
  • Révoquez une clé dans Paramètres à tout moment. Elle cesse de fonctionner dès la requête suivante.
  • Les bons assistants demandent avant de payer, résilier ou supprimer. Vérifiez ces demandes avant de les approuver.
  • Les clés API n'accèdent qu'aux fonctions client. Elles ne peuvent ni créer ni révoquer d'autres clés.

Erreurs

En cas d'échec, l'outil renvoie le statut HTTP et un message. Les plus courants :

400
Données non valides. Le message indique quoi corriger.
401
Clé API absente, incorrecte ou révoquée.
402
Crédits insuffisants. Achetez des crédits et réessayez.
403
Votre compte n'a pas cette fonction.
429
Trop de requêtes. Patientez un peu et réessayez.
AvataReel MCP : créez des vidéos publicitaires depuis votre assistant IA