Passer à la navigation
Plugins et extensionsSkills d’agent

Skill sync-api

Intégrez sync. dans vos applications avec l’API REST ou les SDK Python et TypeScript.

Installez ce skill avec npx skills add synchronicity-labs/skills --skill sync-api, ou obtenez tous les skills avec le plugin Claude Code. Voir Skills d’agent.

Ce qu’il fait

sync-api aide votre agent de code à intégrer sync. dans votre propre application, backend, script ou pipeline. Il écrit du code côté serveur qui importe des médias, crée des générations avec des clés d’idempotence, vérifie les webhooks, interroge l’API en solution de secours, et gère les erreurs et les limites de concurrence, via l’API REST ou les SDK officiels Python (syncsdk) et TypeScript (@sync.so/sdk).

Quand l’utiliser

Ce que vous faitesUtilisez
Écrire ou relire du code qui appelle l’API sync.sync-api
Déboguer une erreur 429, un webhook ou une facturation en doublesync-api
Créer une vidéo dans ce chatlipsync, talking-photo, translate-and-dub
Traiter une seule fois un CSV de travauxbatch-lipsync

Essayez

  • « Ajoute à mon app Express un endpoint qui synchronise les lèvres d’une URL vidéo sur une URL audio avec sync. »
  • « Écris un script Python qui double en espagnol chaque vidéo de ./in »
  • « Ajoute une route Next.js qui vérifie les webhooks sync. »
  • « Notre worker reçoit sans arrêt 429 concurrency_limit_reached. Quelle est la bonne solution ? »

Ce dont vous avez besoin

  • Une clé API sync. obtenue sur sync.so/settings/api-keys, définie dans SYNC_API_KEY sur le serveur. Voir Authentification.
  • Python 3.8 ou version ultérieure, ou Node 18 ou version ultérieure, pour les SDK.

Questions fréquentes

POST /v2/generate accepte un Idempotency-Key. Créé une fois par travail et réutilisé à chaque nouvelle tentative, il transforme une nouvelle tentative après un timeout en rejeu de la génération d’origine au lieu d’une deuxième génération payante. Voir Idempotent Requests.

Les webhooks, vérifiés avec l’en-tête Sync-Signature, pour la production. Une interrogation périodique rattrape les livraisons manquées par votre endpoint.

Les SDK peuvent être en retard sur l’API. Le skill appelle alors cet endpoint en HTTP au lieu de forcer les types.

Attendez le délai indiqué dans la réponse, réessayez avec la même clé d’idempotence et ne gardez pas plus de travaux en cours que la limite de concurrence de votre forfait, avec une file d’attente de votre côté. Voir Concurrence et limites de débit.

Tout fonctionne si

  • La clé API reste sur le serveur, jamais dans du code navigateur ou mobile.
  • Chaque création porte une clé d’idempotence enregistrée avant l’appel.
  • Le gestionnaire de webhooks vérifie la signature sur le corps brut avant de l’analyser.