Passer au contenu principal
Le catalogue contient 61 opérations de compte et 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 comme run_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.