img_uuid retornado e obtenha o resultado por polling ou callback HTTPS.API de efeitos de vídeo com IA para fluxos criativos automatizados
Use os efeitos de vídeo com IA pela API independente da GoEnhance. Liste os modelos de efeito disponíveis, envie uma imagem de referência autorizada junto com um ID de efeito, salve o
Criar uma API Key
Recursos da API de efeitos de vídeo com IA
Descubra os efeitos disponíveis
Chame GET /api/v1/videoeffect/list com autenticação Bearer para obter os IDs de efeito, os rótulos e as URLs de prévia atuais, em vez de fixar um catálogo desatualizado no código.
Crie e acompanhe uma tarefa
Envie por POST um reference_img público e um effect_id válido para /api/v1/videoeffect/generate e guarde o img_uuid retornado para consultar o status.
Valide credenciais, acesso à mídia, identidade do modelo e configuração de callback antes de criar uma tarefa.
Pontos essenciais da requisição à API de efeitos de vídeo com IA
Autenticação Bearer
Envie sua chave de API da GoEnhance no cabeçalho <code>Authorization</code> e mantenha-a no servidor, nunca em código do lado do cliente.
Descoberta de modelos
Use <code>GET /api/v1/videoeffect/list</code> para obter o catálogo atual antes de exibir as opções de efeito no seu produto.
Imagem de referência
Informe em <code>reference_img</code> uma URL de imagem HTTPS de acesso público e use apenas material que seja seu ou que você tenha autorização para processar.
Identificador do efeito
Passe o <code>effect_id</code> exato do modelo escolhido e valide-o com a resposta atual da listagem, em vez de adivinhar identificadores.
Callback opcional
Informe <code>custom_callback_url</code> quando quiser que as notificações de status sejam enviadas para um endpoint HTTPS público.
ID da tarefa assíncrona
Persista o <code>data.img_uuid</code> de uma resposta de envio bem-sucedida e associe-o ao seu registro interno da requisição.
Baseie-se em dados de modelos atualizados e na documentação, e não em um preço universal inventado ou desatualizado.
Preços da API de efeitos de vídeo com IA
O preço varia por efeito
O preço da API de efeitos de vídeo com IA depende do modelo escolhido e do catálogo atual da GoEnhance. Não presuma uma tarifa fixa igual para todos os efeitos.
Consulte o catálogo atualizado
Use a API de listagem de modelos e a documentação atual da GoEnhance como fonte de verdade para o efeito que você pretende executar.
Calcule o custo antes do envio
Defina o <code>effect_id</code> escolhido e confira as condições de cobrança atuais antes de enfileirar lotes de produção, porque os termos do catálogo podem mudar.
Integre efeitos de vídeo com IA em três passos
1
1. Descubra e valide
Busque a lista de efeitos, escolha um
effect_id exato e verifique se sua imagem de referência HTTPS está acessível e autorizada para processamento. 2
2. Envie e persista
Faça POST de
reference_img, effect_id e uma URL de callback opcional e, em seguida, salve o data.img_uuid da resposta. 3
3. Obtenha o resultado final
Faça polling em
GET /api/v1/jobs/detail?img_uuid=... ou processe os corpos de callback de forma idempotente até a tarefa chegar a success ou failed.Monte fluxos de efeito repetíveis em torno de conteúdo que é seu ou que você tem permissão para transformar.
Casos de uso da API de efeitos de vídeo com IA
Ferramentas para criadores
Deixe os usuários escolherem efeitos aprovados e transformarem imagens estáticas autorizadas em peças dinâmicas curtas dentro do seu aplicativo.
Variações de campanha
Enfileire variações de efeito para conceitos de marketing mantendo a titularidade do material, a moderação e a aprovação no seu próprio fluxo.
Pipelines de conteúdo do usuário
Conecte uploads, escolha do efeito, processamento assíncrono e entrega do resultado em um pipeline de backend rastreável.
Experiências de entretenimento
Crie recursos divertidos e animações temáticas de adesão voluntária, com consentimento claro e checagens de política de conteúdo.
Operações criativas em lote
Persista os IDs de tarefa e processe os resultados finais de forma independente, para que os lotes se recuperem de tempos de espera sem envios duplicados.
Automação de mídia
Encaminhe os vídeos concluídos para os sistemas de armazenamento, revisão, moderação e publicação somente depois de validar a resposta final.
Respostas sobre endpoints, preços, entradas, entrega assíncrona e salvaguardas em produção.