pixamake

Documentation

Agents IA et MCP

Connecter Claude, Cursor ou tout agent à Pixamake.

Pixamake est pensé pour les agents IA autant que pour les personnes :

Connecter le serveur MCP

Créez une clé d'API dans API et webhooks, puis ajoutez le serveur à votre client.

Claude Code

claude mcp add --transport http pixamake https://pixamake.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "pixamake": {
      "url": "https://pixamake.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop et autres clients stdio

{
  "mcpServers": {
    "pixamake": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://pixamake.ai/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}

Outils

Outil Rôle
get_account Offre, solde de crédits et limites
estimate_credits Crédits pour une durée de vidéo
create_upload URL signée pour envoyer un fichier local (l'agent envoie ensuite le fichier en HTTP PUT)
create_job Lance le nettoyage depuis video_url ou upload_id
get_job Statut, avancement et lien de téléchargement
wait_for_job Attend jusqu'à 50 secondes la fin d'une tâche, puis la renvoie
list_jobs Tâches récentes de l'espace
cancel_job Arrête une tâche et rend les crédits

Exemple de demande à un agent : « Retire les sous-titres de https://cdn.example.com/pub.mp4 et donne-moi le lien de téléchargement. »

Consignes pour les agents

  • Vérifiez le solde avec get_account avant un gros lot, et prévenez l'utilisateur quand les crédits manquent (402 insufficient_credits).
  • Réutilisez la même Idempotency-Key pour réessayer une création en HTTP.
  • Interrogez une tâche en cours toutes les 5 à 10 secondes, ou appelez wait_for_job en boucle. La plupart des vidéos de 30 secondes prennent quelques minutes.
  • result.url expire au bout d'une heure : téléchargez, ou relisez la tâche pour un nouveau lien.
  • N'affichez jamais la clé d'API dans les réponses ou les journaux.
PrécédentErreurs, limites et nouveaux essais