Skill sync-api
Instale esta skill com npx skills add synchronicity-labs/skills --skill sync-api, ou obtenha todas as skills com o plugin do Claude Code. Veja Skills de agente.
O que faz
A sync-api ajuda o seu agente de programação a integrar a sync. ao seu próprio app, backend, script ou pipeline. Ela escreve código de servidor que envia mídias, cria gerações com chaves de idempotência, verifica webhooks, faz polling como alternativa e trata erros e limites de concorrência, usando a API REST ou os SDKs oficiais de Python (syncsdk) e TypeScript (@sync.so/sdk).
Quando usar
Experimente
- “Adicione ao meu app Express um endpoint que sincroniza os lábios de uma URL de vídeo com uma URL de áudio usando a sync.”
- “Escreva um script Python que duble em espanhol cada vídeo de ./in”
- “Adicione uma rota Next.js que verifique os webhooks da sync.”
- “Nosso worker continua recebendo 429 concurrency_limit_reached. Qual é a correção certa?”
O que você precisa
- Uma chave de API da sync. em sync.so/settings/api-keys, definida como
SYNC_API_KEYno servidor. Veja Autenticação. - Python 3.8 ou posterior, ou Node 18 ou posterior, para os SDKs.
Perguntas frequentes
Por que o código salva uma chave antes de chamar a API?
POST /v2/generate aceita um Idempotency-Key. Criado uma vez por trabalho e reutilizado em cada nova tentativa, ele transforma uma nova tentativa após um timeout em uma repetição da geração original, em vez de uma segunda geração paga. Veja Idempotent Requests.
Webhooks ou polling?
Webhooks, verificados com o cabeçalho Sync-Signature, para produção. Uma consulta periódica pega as entregas que o seu endpoint perdeu.
O SDK não tem um campo que a documentação menciona.
Os SDKs podem ficar atrás da API. A skill chama esse endpoint por HTTP em vez de forçar os tipos.
O que fazer com um 429?
Espere o tempo que a resposta indica, tente de novo com a mesma chave de idempotência e mantenha no máximo o limite de concorrência do seu plano em trabalhos em andamento, com uma fila do seu lado. Veja Concorrência e limites de taxa.
Está funcionando se
- A chave de API fica no servidor, nunca em código de navegador ou de app móvel.
- Cada criação leva uma chave de idempotência que foi salva antes da chamada.
- O handler de webhooks confere a assinatura com o corpo bruto antes de fazer o parse.