Instale o Skill primeiro e deixe seu Agent seguir a documentação oficial para integrar tradução de vídeo, remoção de legendas, dublagem e tradução de imagens.
Envie o prompt abaixo ao seu Agent para adicionar os Skills.
Acesse https://github.com/zhaoli-ai/GhostCut-ai/blob/main/skills.md e siga as instruções para instalar o GhostCut Skill para mim.
Use o comando npx para começar.
npx skills add zhaoli-ai/GhostCut-ai
Legendas / texto / logos
Tradução multilíngue / vozes de IA
OCR / ASR / inserção de SRT
Tradução de imagens / remoção de texto
Why GhostCut
Cobre o fluxo completo de importação, tradução, revisão, remoção, dublagem e inserção até o download do vídeo final. Suporta tanto API + site para integração rápida quanto automação completa via API.
Atende clientes líderes de séries curtas para expansão internacional e também equipes de produção e entrega de séries curtas de IA.
Mais de 2.000 títulos entram na produção diária, ideal para filas de tarefas em lote.
Transforme tradução, dublagem, remoção de legendas e recuperação do vídeo final em ações de produção reutilizáveis.
Customer Paths
Escolha a profundidade de integração conforme o modelo de negócio: empresas podem chamar recursos independentes, equipes de expansão internacional podem combinar fluxos de localização e Agents podem orquestrar o GhostCut como ferramenta.
Integre tradução de imagens, remoção de texto em imagens, remoção de texto em vídeo, geração de legendas e outros recursos independentes ao seu backend existente.
Para equipes de séries curtas e séries de IA em expansão internacional, conecte tradução de legendas, remoção, dublagem e recuperação do vídeo final em um fluxo de produção estável.
Deixe Codex, Cursor, Claude Code ou bots internos lerem o Skill primeiro e depois enviarem tarefas, consultarem status e tratarem callbacks conforme a documentação.
Localization Workflow
Esta seção explica como uma série curta passa do vídeo original para um vídeo final localizado. Você pode conectar apenas o fluxo de front-end e back-end à API, mantendo os ajustes finos no site, ou integrar tradução, revisão, remoção, dublagem e download do vídeo final totalmente pela API.
Os dois modos não são etapas sequenciais; eles representam diferentes profundidades de integração.
Ideal para equipes que querem integrar rapidamente. Use a API primeiro nas etapas mais demoradas e padronizadas: criação de projeto, upload de vídeo, upload de legendas, tradução de legendas e download do vídeo final. Mantenha interações complexas, como revisão de legendas, remoção de legendas e dublagem por IA, no site GhostCut.
Ideal para equipes com sistema interno ou plataforma de automação. Upload do vídeo original, processamento de legendas, revisão, remoção, dublagem, inserção, status da tarefa e recuperação de resultados são todos feitos pela API.
Independentemente do modo de integração, uma série curta normalmente passa por estas etapas.
Crie um projeto pela API e envie o vídeo e as legendas existentes. Se não houver legendas, continue depois com reconhecimento ou tradução.
Traduza legendas em chinês para o idioma de destino. Quando houver necessidade de revisão humana, revise no site; quando for preciso processamento sistemático, continue pela API.
Remova as legendas originais conforme o vídeo de origem, insira novas legendas e escolha se deseja dublagem por IA, clonagem de voz ou manter o áudio de fundo.
Quando a tarefa terminar, obtenha o status por callback ou polling, baixe o vídeo final e envie-o de volta para sua biblioteca de conteúdo, sistema de mídia ou fluxo de publicação.
Minimum Call Shape
Após instalar o Skill, a chamada mínima não é um curl isolado, mas um ciclo repetível: credenciais -> payload -> POST assinado -> work ID -> consulta de status.
import hashlib
import json
import os
import requests
APP_KEY = os.environ["GHOSTCUT_APP_KEY"]
APP_SECRET = os.environ["GHOSTCUT_APP_SECRET"]
BASE_URL = "https://api.zhaoli.com"
VIDEO_URL = "https://example.com/input.mp4"
def post(path, payload):
body = json.dumps(payload, ensure_ascii=False, separators=(",", ":"))
body_md5 = hashlib.md5(body.encode("utf-8")).hexdigest()
app_sign = hashlib.md5((body_md5 + APP_SECRET).encode("utf-8")).hexdigest()
response = requests.post(
BASE_URL + path,
headers={
"Content-Type": "application/json",
"AppKey": APP_KEY,
"AppSign": app_sign,
},
data=body.encode("utf-8"),
timeout=30,
)
response.raise_for_status()
return response.json()
payload = {
"urls": [VIDEO_URL],
"needChineseOcclude": 2,
"videoInpaintLang": "all",
"extraOptions": json.dumps(
{"extra_inpaint_config": {"model": "advanced_lite"}},
separators=(",", ":"),
),
"videoInpaintMasks": json.dumps(
[{
"type": "remove_only_ocr",
"start": 0,
"end": 99999,
"region": [[0, 0], [1, 0], [1, 1], [0, 1]],
}],
separators=(",", ":"),
),
}
result = post("/v-w-c/gateway/ve/work/free", payload)
work_id = result["body"]["dataList"][0]["id"]
print("work_id:", work_id)
status = post("/v-w-c/gateway/ve/work/status", {"idWorks": [work_id]})
print(json.dumps(status, ensure_ascii=False, indent=2))Substitua VIDEO_URL pela sua URL pública de vídeo. Vídeos locais precisam ser enviados primeiro para obter uma URL acessível. Configure AppKey e AppSecret por variáveis de ambiente antes de executar.
O exemplo serializa o payload em JSON compacto, gera o cabeçalho com AppSign = md5(md5(body_str) + AppSecret) e envia exatamente o mesmo body_str.
Depois que /work/free retornar sucesso, salve body.dataList[0].id. Consulte resultados de vídeo comuns com /work/status; processStatus == 1 significa processamento concluído com sucesso.
Para mídia local, solicite credenciais de upload primeiro, envie o arquivo para o OSS e use a URL retornada nas chamadas seguintes.
Demo Scenarios
Abaixo estão exemplos de parâmetros para três tarefas frequentes. O código de exemplo pressupõe que o helper de requisição assinada já foi encapsulado: ghostcutPost(path, payload)。
Use coordenadas relativas em tela cheia para validar inpainting de vídeo, envio de tarefa e recuperação de resultado.
Traduza uma série curta em chinês para inglês, mantenha o áudio de fundo original e insira as legendas traduzidas.
Reconheça conteúdo em chinês na imagem, traduza para inglês e sintetize uma nova imagem.
const payload = {
urls: ["https://gc100.cdn.izhaoli.cn/demo/1691660164246.mp4"],
needChineseOcclude: 2,
videoInpaintLang: "all",
extraOptions: JSON.stringify({
extra_inpaint_config: { model: "advanced_lite" }
}),
videoInpaintMasks: JSON.stringify([{
type: "remove_only_ocr",
start: 0,
end: 99999,
region: [[0, 0], [1, 0], [1, 1], [0, 1]]
}])
};
const task = await ghostcutPost("/v-w-c/gateway/ve/work/free", payload);
const workId = task.body.dataList[0].id;const payload = {
urls: ["http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.mp4"],
needWanyin: 1,
sourceLang: "zh",
lang: "en",
wyTaskType: "VOICE_CLONE_PRO",
wyNeedText: 1,
removeBgAudio: 0,
wyVoiceParam: JSON.stringify({
font_param: {
style: "tpl-31-1-T",
font_size: 32,
position: 0.727,
subtitleLang: "en"
}
})
};
const task = await ghostcutPost("/v-w-c/gateway/ve/work/free", payload);
const workId = task.body.dataList[0].id;const payload = {
downloadInfo: JSON.stringify({
url: "https://gc100.cdn.izhaoli.cn/ve_material_image/A-00b4943646344cfc/e2d6dd82903f4059bd94c9b660f5f7b6/1782789120948.webp"
}),
translateOn: 1,
srcLang: "zh",
tgtLang: "en",
commodityFilterOn: 0,
synthesisOn: 1
};
const task = await ghostcutPost("/v-w-c/gateway/ve/image/translate", payload);
const result = await ghostcutPost("/v-w-c/gateway/ve/image/translate/query", {
id: task.body
});Integration Path
Das credenciais aos resultados processados, a integração da API GhostCut se divide em quatro etapas: preparar acesso, instalar o Skill, enviar a primeira tarefa e receber ou consultar resultados.
Depois de entrar no GhostCut, abra Central do Usuário, crie acesso à API em "Minha conta" e obtenha AppKey e AppSecret para assinar requisições.
Agents devem ler skills.md e instalar o ghostcut-skill primeiro. Desenvolvedores podem executar npx skills add zhaoli-ai/GhostCut-ai.
Use o exemplo de chamada mínima para enviar uma tarefa de remoção de texto em vídeo e validar assinatura AppSign, criação da tarefa e fluxo de consulta de status.
Em produção, envie callback ao criar a tarefa e mantenha polling como fallback. Consulte resultados de vídeo com /work/status e tarefas de imagem com /image/translate/query.
Billing
A cobrança da API segue as mesmas regras do site GhostCut. Você pode primeiro fazer testes com a conta do site e depois escolher o pacote adequado conforme volume de tarefas, concorrência e prazo de entrega.
Production Rules
A duração atual da mídia é limitada a 15 minutos e cada arquivo deve ter menos de 1000MB. Divida vídeos mais longos e comprima arquivos grandes antes.
URLs de vídeo, imagem e SRT não devem depender de login, intranet ou caminhos locais, e não devem conter caracteres chineses.
Imagens não podem exceder 2000 * 2000 px e 50MB. Formatos compatíveis: png, jpeg, jpg, bmp, webp. Envie imagens locais primeiro.
Verifique Callback-Sign, faça deduplicação por work ID ou task ID e retorne HTTP 200 com body não vazio após persistir ou enfileirar o evento.
Callbacks com falha são tentados novamente a cada cerca de 30 minutos por 24 horas. Mesmo usando callback, mantenha polling de compensação.
For AI Coding Tools
Entregue a Codex, Cursor, Claude Code, bots internos ou Agents automatizados o ponto de instalação, o ciclo mínimo, a assinatura de autenticação, o callback assíncrono e o índice legível por máquina. Credenciais devem ser fornecidas apenas por variáveis de ambiente, e os campos reais seguem a documentação do Skill.
FAQ
Esclareça antes da integração os conceitos, acessos, cenários, tarefas assíncronas, mídia e cobrança mais comuns para reduzir tentativa e erro de desenvolvedores e Agents.
A API GhostCut oferece tradução de vídeo, remoção de legendas, dublagem, tradução de imagens e recursos relacionados. O GhostCut Skill é o guia de integração lido por AI Agents e ferramentas de AI Coding para instalar, autenticar, assinar requisições e chamar a API pelo fluxo oficial.
Entre na sua conta GhostCut e abra Central do Usuário, crie acesso à API em "Minha conta" e obtenha AppKey e AppSecret para assinar requisições.
Ela é indicada para expansão internacional de séries curtas, localização de séries curtas de IA, localização de materiais de ecommerce, remoção de legendas em vídeo, tradução de imagens, dublagem em lote, sistemas internos de produção de conteúdo e fluxos automatizados de Agent.
Sim. Você pode integrar criação de projeto, upload de mídia, tradução de legendas, revisão, remoção de legendas, dublagem por IA, download do vídeo final e etapas relacionadas, ou usar apenas recursos específicos em conjunto com o site GhostCut.
O processamento de vídeos e imagens normalmente é assíncrono. Depois de enviar uma tarefa, obtenha primeiro o ID da tarefa ou do work e depois recupere o resultado final pela API de consulta de status ou por callback. Em produção, priorize callback e mantenha polling como fallback.
Não. A mídia precisa ser uma URL acessível publicamente. Para mídia local, solicite credenciais de upload primeiro, envie o arquivo para o OSS e use a URL retornada nas chamadas seguintes.
Verifique primeiro se o AppSign foi gerado a partir exatamente do mesmo corpo da requisição, se a URL da mídia é pública, se tamanho e formato do arquivo respeitam os limites, se o ID correto da tarefa foi usado e se o status final foi confirmado pela API de consulta correta.
A API GhostCut usa as mesmas regras de cobrança do site GhostCut. Tarefas enviadas pela API e tarefas criadas no site compartilham assinatura, créditos e cotas na mesma conta. Antes de entrar em produção, confirme saldo da conta, volume estimado de tarefas, necessidades de concorrência e prazo de entrega. Pacotes, cotas e preços seguem o documento de cobrança.