get_capabilities. Seuls les outils autorisés sont visibles. Les droits et la propriété des ressources sont vérifiés à chaque appel. Consultez le démarrage rapide.
Sauf pour get_capabilities, les champs ci-dessous vont dans arguments.input. Une écriture exige aussi arguments.idempotencyKey : 1 à 191 caractères ASCII imprimables sans espaces. Les champs avec une valeur par défaut sont facultatifs. Respectez notamment page_size et pageSize. Utilisez le schéma actuel de tools/list.
Le résultat figure dans structuredContent et en texte JSON dans content. La première exécution renvoie l’enveloppe ci-dessous. Une répétition renvoie replayed: true et un petit receipt avec les identifiants disponibles, sans résultat complet ni secret de clé.
execution_pending (409) indique un premier appel non résolu. execution_unknown (409) ou status: unknown signifie que l’action a peut-être déjà eu lieu. Consulter get_execution, puis la tâche, commande ou action concernée. Ne pas contourner cet état avec une nouvelle clé. Une exécution MCP terminée peut encore contenir une tâche de modèle ou une confirmation en attente.
La collecte des résultats de modèle est limitée à 8 Mio et 300 secondes. En cas d’interruption ou de dépassement, le reçu d’exécution conserve tout request_id connu. Vérifier get_execution et la requête ou tâche existante avant d’agir ; ne pas créer une nouvelle requête payante ni une nouvelle clé d’idempotence pour remplacer un appel non résolu. Une déconnexion du client ne signifie pas qu’une tâche acceptée a été annulée.
get_capabilities
Lecture · arguments: {}
Après initialisation, appeler get_capabilities avec {} puis lire tools/list. La réponse contient audience: user, ownership: self, les scopes, les outils autorisés et oauth: false. Tous les autres outils personnels utilisent un objet input, même sans paramètres métier.
list_models
Permissions requises: models:read · Lecture
Résultat: Renvoie items, total, page, page_size, les ID publics, prix et capacités des modèles.
get_model_schema
Permissions requises: models:read · Lecture
Résultat: Renvoie les paramètres, capacités et prix d’un modèle autorisé.
get_api_guide
Permissions requises: models:read · Lecture
Résultat: Renvoie les URL, exemples d’authentification, points d’accès et instructions de suivi pour format.
chat_completion
Permissions requises: models:invoke · Écriture ; idempotencyKey obligatoire
Résultat: Renvoie le status HTTP, request_id, credits_charged, content_type et response ou les events collectés. Suivez les tâches asynchrones avec get_task ; acceptation ne signifie pas achèvement.
body contient toute la requête HTTP JSON. generate_content exige le model extérieur ; les autres lisent body.model. files associe les champs d’édition d’image aux tableaux d’ID personnels et exige files:write. client_request_id sert au suivi vidéo. Voir la référence HTTP.
create_response
Permissions requises: models:invoke · Écriture ; idempotencyKey obligatoire
Résultat: Renvoie le status HTTP, request_id, credits_charged, content_type et response ou les events collectés. Suivez les tâches asynchrones avec get_task ; acceptation ne signifie pas achèvement.
body contient toute la requête HTTP JSON. generate_content exige le model extérieur ; les autres lisent body.model. files associe les champs d’édition d’image aux tableaux d’ID personnels et exige files:write. client_request_id sert au suivi vidéo. Voir la référence HTTP.
create_message
Permissions requises: models:invoke · Écriture ; idempotencyKey obligatoire
Résultat: Renvoie le status HTTP, request_id, credits_charged, content_type et response ou les events collectés. Suivez les tâches asynchrones avec get_task ; acceptation ne signifie pas achèvement.
body contient toute la requête HTTP JSON. generate_content exige le model extérieur ; les autres lisent body.model. files associe les champs d’édition d’image aux tableaux d’ID personnels et exige files:write. client_request_id sert au suivi vidéo. Voir la référence HTTP.
generate_content
Permissions requises: models:invoke · Écriture ; idempotencyKey obligatoire
Résultat: Renvoie le status HTTP, request_id, credits_charged, content_type et response ou les events collectés. Suivez les tâches asynchrones avec get_task ; acceptation ne signifie pas achèvement.
body contient toute la requête HTTP JSON. generate_content exige le model extérieur ; les autres lisent body.model. files associe les champs d’édition d’image aux tableaux d’ID personnels et exige files:write. client_request_id sert au suivi vidéo. Voir la référence HTTP.
generate_image
Permissions requises: models:invoke · Écriture ; idempotencyKey obligatoire
Résultat: Renvoie le status HTTP, request_id, credits_charged, content_type et response ou les events collectés. Suivez les tâches asynchrones avec get_task ; acceptation ne signifie pas achèvement.
body contient toute la requête HTTP JSON. generate_content exige le model extérieur ; les autres lisent body.model. files associe les champs d’édition d’image aux tableaux d’ID personnels et exige files:write. client_request_id sert au suivi vidéo. Voir la référence HTTP.
generate_image_sync
Permissions requises: models:invoke · Écriture ; idempotencyKey obligatoire
Résultat: Renvoie le status HTTP, request_id, credits_charged, content_type et response ou les events collectés. Suivez les tâches asynchrones avec get_task ; acceptation ne signifie pas achèvement.
body contient toute la requête HTTP JSON. generate_content exige le model extérieur ; les autres lisent body.model. files associe les champs d’édition d’image aux tableaux d’ID personnels et exige files:write. client_request_id sert au suivi vidéo. Voir la référence HTTP.
edit_image
Permissions requises: models:invoke · Écriture ; idempotencyKey obligatoire
Résultat: Renvoie le status HTTP, request_id, credits_charged, content_type et response ou les events collectés. Suivez les tâches asynchrones avec get_task ; acceptation ne signifie pas achèvement.
body contient toute la requête HTTP JSON. generate_content exige le model extérieur ; les autres lisent body.model. files associe les champs d’édition d’image aux tableaux d’ID personnels et exige files:write. client_request_id sert au suivi vidéo. Voir la référence HTTP.
Avant de lire le contenu, les opérations vérifient la propriété, l’état prêt, le nombre et la taille des fichiers. Chaque référence compte dans les limites, y compris les ID répétés.
edit_image : au plus 20 fichiers tous champs confondus, dont un seul mask ; 50 Mio par fichier / 100 Mio au total. Les limites de tableau par champ du schéma restent applicables.
generate_video
Permissions requises: models:invoke · Écriture ; idempotencyKey obligatoire
Résultat: Renvoie le status HTTP, request_id, credits_charged, content_type et response ou les events collectés. Suivez les tâches asynchrones avec get_task ; acceptation ne signifie pas achèvement.
body contient toute la requête HTTP JSON. generate_content exige le model extérieur ; les autres lisent body.model. files associe les champs d’édition d’image aux tableaux d’ID personnels et exige files:write. client_request_id sert au suivi vidéo. Voir la référence HTTP.
generate_video_sync
Permissions requises: models:invoke · Écriture ; idempotencyKey obligatoire
Résultat: Renvoie le status HTTP, request_id, credits_charged, content_type et response ou les events collectés. Suivez les tâches asynchrones avec get_task ; acceptation ne signifie pas achèvement.
body contient toute la requête HTTP JSON. generate_content exige le model extérieur ; les autres lisent body.model. files associe les champs d’édition d’image aux tableaux d’ID personnels et exige files:write. client_request_id sert au suivi vidéo. Voir la référence HTTP.
moderate_content
Permissions requises: models:invoke · Écriture ; idempotencyKey obligatoire
Résultat: Renvoie le status HTTP, request_id, credits_charged, content_type et response ou les events collectés. Suivez les tâches asynchrones avec get_task ; acceptation ne signifie pas achèvement.
body contient toute la requête HTTP JSON. generate_content exige le model extérieur ; les autres lisent body.model. files associe les champs d’édition d’image aux tableaux d’ID personnels et exige files:write. client_request_id sert au suivi vidéo. Voir la référence HTTP.
upload_image
Permissions requises: models:invoke, files:write · Écriture ; idempotencyKey obligatoire
Résultat: Publie un JPEG, PNG ou WebP et renvoie son URL utilisable par un modèle dans la réponse standard. Cette URL peut être partagée.
Avant de lire le contenu, les opérations vérifient la propriété, l’état prêt, le nombre et la taille des fichiers. Chaque référence compte dans les limites, y compris les ID répétés.
upload_image : un fichier de 50 Mio maximum.
upload_media
Permissions requises: files:write · Écriture ; idempotencyKey obligatoire
Résultat: Publie les images, vidéos ou fichiers audio et renvoie leurs URL partageables. La publication est distincte de l’envoi privé.
Avant de lire le contenu, les opérations vérifient la propriété, l’état prêt, le nombre et la taille des fichiers. Chaque référence compte dans les limites, y compris les ID répétés.
upload_media : au plus 20 fichiers / 250 Mio au total.
get_task
Permissions requises: models:invoke · Lecture
Résultat: État et résultat d’une tâche existante, sans nouvelle tâche ni nouvelle facturation.
list_utilities
Permissions requises: models:read · Lecture
Résultat: items avec id, titre, description, méthode, body_kind, response_kind, fields, limits et access.
get_utility_schema
Permissions requises: models:read · Lecture
Résultat: Champs, types de fichiers, valeurs par défaut, limites et conditions d’accès de l’utilitaire.
run_utility
Permissions requises: utilities:invoke · Écriture ; idempotencyKey obligatoire
Résultat: Renvoie status et un result JSON, ou un artifact temporaire pour les résultats binaires/volumineux. Les fichiers et sorties non JSON exigent aussi files:write. Les quotas et conditions d’accès payant restent applicables.
Avant de lire le contenu, les opérations vérifient la propriété, l’état prêt, le nombre et la taille des fichiers. Chaque référence compte dans les limites, y compris les ID répétés.
run_utility : les limites de nombre, de taille individuelle et totale de get_utility_schema s’appliquent, avec un plafond absolu de 250 Mio au total, même si le catalogue autorise davantage.
begin_upload
Permissions requises: files:write · Écriture ; idempotencyKey obligatoire
Résultat: Métadonnées : id, name, mime_type, size, status, expires_at, sha256. Utilisez ensuite id comme file_id.
upload_chunk
Permissions requises: files:write · Écriture ; idempotencyKey obligatoire
Résultat: file_id, index, received: true. Maximum 1 Mio après décodage Base64 ; un index réutilisé exige les mêmes octets.
finish_upload
Permissions requises: files:write · Écriture ; idempotencyKey obligatoire
Résultat: Métadonnées vérifiées avec status: ready et SHA-256. Tous les blocs consécutifs et la taille déclarée exacte sont requis.
get_artifact
Permissions requises: files:write · Lecture
Résultat: Sans offset : métadonnées et download_url nécessitant une connexion au site. Avec offset : data Base64, offset, next_offset ; null indique la fin. Lecture par défaut : 1 Mio.
list_api_keys
Permissions requises: keys:read · Lecture
Résultat: Paramètres et préfixes paginés, sans secrets.
get_api_key
Permissions requises: keys:read · Lecture
Résultat: Paramètres de votre clé sans son secret.
create_api_key
Permissions requises: keys:write · Écriture ; idempotencyKey obligatoire
Résultat: Métadonnées uniquement. Le secret nécessite une validation sur le site. purpose est un libellé sans droits MCP.
update_api_key
Permissions requises: keys:write · Écriture ; idempotencyKey obligatoire
Résultat: Paramètres mis à jour ; fournir au moins un réglage en plus de key_id.
set_api_key_status
Permissions requises: keys:write · Écriture ; idempotencyKey obligatoire
Résultat: Paramètres avec l’état active ou disabled.
delete_api_key
Permissions requises: keys:write · Écriture ; idempotencyKey obligatoire
Résultat: id, status: deleted, deletedAt vérifiés. Une clé supprimée ne peut pas être réactivée.
start_reveal_key_action
Permissions requises: keys:secrets · Écriture ; idempotencyKey obligatoire
Résultat: Action en attente avec id, confirmation_url, expires_at et effet prévu, sans secret.
reveal_api_key
Permissions requises: keys:secrets · Écriture ; idempotencyKey obligatoire
Résultat: Après validation : action_id, key_id et key en clair, une seule fois. Une répétition ne renvoie pas le secret.
get_profile
Permissions requises: account:read · Lecture
Résultat: Profil, abonnement actuel et droits freeApi, RPM et accès par lot.
Aucun champ : utiliser input: {}.
get_account_capabilities
Permissions requises: account:read · Lecture
Résultat: scopes, bound_api_key_id, niveau/RPM free_api et actions à confirmer.
Aucun champ : utiliser input: {}.
update_profile
Permissions requises: account:write · Écriture ; idempotencyKey obligatoire
Résultat: Profil mis à jour. Fournir name ou image ; une image vide l’efface. URL HTTP(S) ou data URL d’image acceptée.
list_login_records
Permissions requises: account:read · Lecture
Résultat: Connexions récentes dans items : date, méthode, IP et lieu, sans jeton de session.
get_integration_config
Permissions requises: account:read · Lecture
Résultat: URL API et MCP avec des identifiants fictifs uniquement.
Aucun champ : utiliser input: {}.
start_account_action
Permissions requises: account:write · Écriture ; idempotencyKey obligatoire
Résultat: Action à confirmer sur le site. Mot de passe et suppression du compte se traitent sur le site.
get_account_action
Permissions requises: account:read · Lecture
Résultat: status, lien de confirmation, expiration, ressource et date d’achèvement de votre action.
get_balance
Permissions requises: billing:read · Lecture
Résultat: balance du compte et, le cas échéant, budget et crédit restant de la clé liée.
Aucun champ : utiliser input: {}.
list_credit_transactions
Permissions requises: billing:read · Lecture
Résultat: Mouvements de crédits paginés : montants, sens, état, dates et commande ou abonnement associé.
list_orders
Permissions requises: billing:read · Lecture
Résultat: Commandes paginées avec état, montant, devise, produit et dates de paiement. Une commande créée ne prouve pas le paiement.
list_billing_products
Permissions requises: billing:read · Lecture
Résultat: ID produits, prix, devises et crédits actuels. Utiliser un productId renvoyé comme product_id pour le paiement.
Aucun champ : utiliser input: {}.
create_checkout
Permissions requises: billing:write · Écriture ; idempotencyKey obligatoire
Résultat: checkout_url et order_no. L’utilisateur paie sur le site ; vérifier avec get_payment_status.
get_payment_status
Permissions requises: billing:read · Lecture
Résultat: État du paiement, montant, devise et date, avec l’état de vérification si applicable.
get_invoice
Permissions requises: billing:read, files:write · Écriture ; idempotencyKey obligatoire
Résultat: order_no et PDF temporaire file. Disponibilité selon le moyen de paiement ; une clé d’idempotence est requise pour créer le fichier.
resend_invoice
Permissions requises: billing:write · Écriture ; idempotencyKey obligatoire
Résultat: order_no, email destinataire, sent: true. Envoie réellement la facture à l’adresse de la commande ; uniquement sur demande.
list_subscriptions
Permissions requises: billing:read · Lecture
Résultat: Métadonnées d’abonnements paginées, produit, état, période et dates de résiliation.
get_current_subscription
Permissions requises: billing:read · Lecture
Résultat: Métadonnées subscription, ou null sans abonnement actuel.
Aucun champ : utiliser input: {}.
cancel_subscription
Permissions requises: billing:write · Écriture ; idempotencyKey obligatoire
Résultat: Démarre une confirmation pour un abonnement. La résiliation n’est effective qu’après validation sur le site et vérification de l’achèvement.
list_redemptions
Permissions requises: billing:read · Lecture
Résultat: Vos derniers codes utilisés dans items.
redeem_code
Permissions requises: billing:write · Écriture ; idempotencyKey obligatoire
Résultat: credits ajoutés et redeemed: true. Un code invalide ou déjà utilisé renvoie une erreur.
get_credit_alert
Permissions requises: billing:read · Lecture
Résultat: Seuil, activation email/webhook, webhookConfigured et fréquence, sans URL secrète.
Aucun champ : utiliser input: {}.
update_credit_alert
Permissions requises: billing:write · Écriture ; idempotencyKey obligatoire
Résultat: Préférences mises à jour ; au moins un réglage requis. Les URL webhook doivent être des adresses HTTP(S) publiques.
test_credit_alert
Permissions requises: billing:write · Écriture ; idempotencyKey obligatoire
Résultat: Envoie une vraie alerte de solde via delivery ; renvoie le mode, le solde, le seuil et le statut HTTP disponible. Uniquement sur demande.
get_overview
Permissions requises: usage:read · Lecture
Résultat: Synthèse selon timezoneOffset : utilisateur, solde, clés, utilisation, activité récente et abonnement.
list_usage
Permissions requises: usage:read · Lecture
Résultat: Requêtes conservées paginées et window UTC ; les tokens en cache inconnus restent null.
Les filtres utilisent des dates ISO 8601 avec fuseau :
from inclus, to exclu. Fenêtre par défaut de 30 jours, maximum 366. Seuls les enregistrements conservés sont couverts ; un jour absent ne prouve pas une utilisation nulle. get_overview.timezoneOffset suit JavaScript getTimezoneOffset en minutes (UTC moins heure locale), défaut 0. Les listes et synthèses restent en UTC.
get_usage_detail
Permissions requises: usage:read · Lecture
Résultat: État, durée et facturation. Le contenu exige include_content: true, usage:content et l’enregistrement du contenu activé sur la clé.
diagnose_request
Permissions requises: usage:read · Lecture
Résultat: request_id, task_id, état, code d’erreur réel, facturation/remboursement et conseils, sans appel de modèle ni nouvel essai automatique.
summarize_usage
Permissions requises: usage:read · Lecture
Résultat: totals, groups, group_by, window UTC sur toutes les requêtes conservées correspondantes. Jours absents omis ; cachedTokens inconnu. Remboursements limités aux tâches asynchrones liées.
Les filtres utilisent des dates ISO 8601 avec fuseau :
from inclus, to exclu. Fenêtre par défaut de 30 jours, maximum 366. Seuls les enregistrements conservés sont couverts ; un jour absent ne prouve pas une utilisation nulle. get_overview.timezoneOffset suit JavaScript getTimezoneOffset en minutes (UTC moins heure locale), défaut 0. Les listes et synthèses restent en UTC.
Dans summarize_usage, creditsCharged et netCreditsCharged sont le débit net conservé. linkedRefundCredits couvre les remboursements connus liés aux tâches asynchrones seulement. knownGrossCredits les ajoute au net, sans représenter une dépense brute complète. totalTokens, averageLatencyMs, pending, processing concernent les requêtes conservées correspondantes.
list_executions
Permissions requises: account:read · Lecture
Résultat: Reçus paginés : opération, état, identifiants, code d’erreur et dates.
get_execution
Permissions requises: account:read · Lecture
Résultat: Un reçu personnel pour vérifier pending ou unknown ; sans restitution de la sortie complète ni de secrets.
Catalogue : 32 utilitaires
Utiliser le slug commerun_utility.input.utility. Lire d’abord get_utility_schema : fields précise noms, types, obligations, valeurs par défaut, multiplicité et formats ; limits et access précisent tailles, nombre de fichiers et droits. Ne pas déduire le schéma par lot de la version unitaire.