AiVideoEditor
Comece grátis
Menu

Revisado em 2026-11-11 · Versão da API 2026-11-09 · Ler Markdown

Publicação e agendamento

Uma publicação do AiVideoEditor tem um rascunho versionado e entregas independentes para as contas selecionadas. O salvamento de rascunhos é permissivo; um salvamento bem-sucedido não estabelece que todos os destinos estão prontos para publicação.

Preparar uma publicação

  1. Leia /api/v1/accounts e /api/v1/capabilities com a chave pretendida.
  2. Envie e finalize qualquer mídia necessária.
  3. Crie um rascunho com POST /api/v1/posts ou edite com PATCH /api/v1/posts/{id}. Forneça o expectedVersion atual nas edições e preserve a versão retornada.
  4. Defina o formato do destino e substituições explícitas de variante por conta onde necessário. A referência da API define os campos da solicitação.
  5. Valide com POST /api/v1/posts/{id}/validate. HTTP 200 pode conter valid: false; inspecione cada problema antes de enviar. Contas inválidas não são removidas silenciosamente da audiência.

Publicar agora ou mais tarde

POST /posts/{id}/publish envia o rascunho atual. POST /posts/{id}/schedule exige scheduledAt, timezone e expectedVersion. O instante agendado deve estar no futuro e dentro de 90 dias. Armazene um carimbo de data/hora UTC e um fuso horário de exibição IANA separado; resolva ambiguidades de horário de verão antes de enviar.

Use uma Idempotency-Key distinta para cada nova mutação. Retenha essa chave e o corpo exato da solicitação antes de enviar. Após um timeout, repita a solicitação idêntica com a mesma chave. Mude a chave apenas quando pretender solicitar uma nova operação. Uma edição ou agendamento de rascunho desatualizado retorna revision_conflict; releia e revise o conteúdo mais recente em vez de sobrescrevê-lo às cegas.

Uma resposta 202 significa aceito para despacho. Não é evidência de publicação. Registre os IDs de entrega e observe GET /posts/{id} ou webhooks assinados do cliente. Use sondagem limitada com atrasos crescentes; pare em resultados terminais ou em uma transferência para um humano em vez de repetir indefinidamente.

Resultados por destino

As entregas podem se resolver de forma independente. Um destino pode publicar enquanto outro precisa de reconexão ou consentimento. Mostre cada estado e o link da publicação nativa quando presente. Tente novamente apenas uma falha conhecida elegível usando POST /deliveries/{id}/retry. Destinos bem-sucedidos não devem ser recriados para recuperar um com falha. Um resultado externo desconhecido precisa de reconciliação ou revisão, não de um novo envio.

Cancele com POST /deliveries/{id}/cancel enquanto o trabalho permanecer seguramente não reivindicado. too_late_to_cancel significa que o envio progrediu além do ponto de cancelamento seguro; não significa que a publicação externa foi removida.

Revisão humana do TikTok

Leia /accounts/{id}/tiktok/settings para ver as configurações atuais do criador e as escolhas de privacidade disponíveis. Uma leitura de configurações ou um salvamento de rascunho não fornece consentimento. consent_required inclui uma transferência segura requiresAction para o compositor autenticado. Uma pessoa autorizada revisa o vídeo exato, a legenda e o destino e confirma explicitamente as escolhas necessárias ali. Chaves de produto e ferramentas MCP não podem confirmar em seu nome. Alterações de conteúdo ou de identidade exigem nova revisão. A transferência, por si só, não concede membership nem acesso.

Controles do compositor

Use Add media para enviar um arquivo ou escolher um item existente da biblioteca. A legenda é compartilhada até que Customize content crie uma variante específica da conta. As ferramentas de emoji e hashtag inserem texto comum no cursor.

Posting options agrupa as configurações da conta selecionada. As escolhas obrigatórias permanecem visíveis; os grupos opcionais permanecem recolhidos. As alterações se aplicam apenas a essa conta. Preview mostra o rascunho efetivo sem salvá-lo nem enviá-lo, incluindo rascunhos incompletos; a apresentação nativa da plataforma pode ser diferente.

Use referências de ativos privados para capas e miniaturas agendadas. As alternativas de URL públicas devem permanecer acessíveis no momento da entrega. O conteúdo de subtítulos é armazenado junto com as configurações imutáveis, em vez de depender de um arquivo local temporário. O upload de documentos do LinkedIn atualmente aceita PDF; os formatos Office continuam restritos até que a validação de assinatura seja implementada.

Consulte a referência de capacidades para os controles canônicos e os limites de integração. O novo comportamento de formato e de confirmação exige as migrações de banco de dados correspondentes antes da implantação.