Combinar edição e extensão
Nesta página
Atualizado a 2 de novembro de 2026. Com base na referência da API de vídeo da xAI: a imagem de origem coloca-se num objeto
image, e o vídeo a editar ou estender num objetovideo({"url": ...}), tanto para extensão como para edição. Fontes: Extensão de Vídeo · Referência de Vídeos.
Pipelines de produção avançados
Utilizados isoladamente, cada endpoint tem limites: a geração limita-se a 15 segundos, a edição a 8,7 segundos de origem e a extensão a 10 segundos adicionados. Combinados, formam pipelines de produção que excedem largamente estes limites e, crucialmente, dão-lhe um ponto de controlo após cada segmento. Esta lição abrange três pipelines do mundo real, desde clipes de produto a variações estilísticas, e como torná-los fiáveis.
Pipeline 1: Um spot publicitário de produto de 15 segundos
O cenário é clássico: tem uma fotografia de um smartphone e precisa de entregar um vídeo promocional de 15 segundos. O pipeline constrói-se em três segmentos de 5 segundos, cada um validado antes do seguinte.
O primeiro segmento anima a fotografia do produto — rotação, jogo de reflexos — através da imagem-para-vídeo estudada na secção anterior.
{
"model": "grok-imagine-video",
"prompt": "Elegant rotation of the smartphone on a dark background, light reflections on the screen",
"image": {"url": "https://exemple.com/smartphone.jpg"},
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}
O segundo estende esta tomada com uma extensão que aproxima a câmara do ecrã, reinjetando o URL obtido no passo anterior.
{
"model": "grok-imagine-video",
"prompt": "Progressive zoom towards the smartphone screen turning on, displaying a colorful interface",
"video": {"url": "{url_video_etape_1}"},
"duration": 5
}
O terceiro fecha a sequência num plano aberto, partindo desta vez do resultado do segundo segmento.
{
"model": "grok-imagine-video",
"prompt": "Zoom out revealing the smartphone placed on a design desk, soft light, slight background blur",
"video": {"url": "{url_video_etape_2}"},
"duration": 5
}
Quinze segundos de novo conteúdo, a $0,05 por segundo com grok-imagine-video: espere cerca de $0,75 excluindo iterações se cada segmento for faturado pela sua duração. O custo real de cada passo aparece no campo usage.cost_in_usd_ticks do seu resultado: verifique isto num pipeline de teste antes de orçamentar uma série.
Pipeline 2: Cinco conteúdos, um estilo
Situação diferente, lógica diferente: precisa de produzir cinco vídeos de 5 segundos para uma campanha nas redes sociais com um estilo visual consistente. Aqui, o encadeamento não estrutura o trabalho; são as imagens de referência que o fazem, idênticas para todas as gerações. Os cinco prompts descrevem cenas diferentes; o estilo mantém-se consistente graças aos mesmos dois visuais.
references = [
{"url": "https://exemple.com/style-campagne-1.jpg"},
{"url": "https://exemple.com/style-campagne-2.jpg"}
]
prompts = [
"Coffee pouring into a white ceramic cup, rising steam",
"Hands typing on a keyboard, blurred screen in background",
"An open notebook with a pen writing, natural light",
"A green plant growing in timelapse in a clay pot",
"A book whose pages turn in the wind on a terrace"
]
for prompt in prompts:
resp = httpx.post(
"https://api.x.ai/v1/videos/generations",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": prompt,
"reference_images": references,
"duration": 5,
"aspect_ratio": "9:16",
"resolution": "720p"
}
)
Cinco clipes de 5 segundos totalizam $1,25. Note o formato 9:16 aplicado a todos os pedidos: para uma campanha vertical, este é o tipo de descuido que custa uma regeneração completa.
Pipeline 3: Derivar variantes a partir de um vídeo
O terceiro esquema não encadeia nada: aplica várias edições diferentes em paralelo ao mesmo vídeo de origem. Obtém assim quatro versões do mesmo clipe, para propor testes A/B ou para distribuir por plataformas com identidades distintas.
video_source = "https://exemple.com/video-base.mp4"
variations = [
"Cinematic black and white style, film grain",
"Pop art saturated colors, strong contrasts",
"Night ambiance, purple and blue neon lights",
"Watercolor style, soft outlines and washed colors"
]
for variation in variations:
resp = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": variation,
"video": {"url": video_source}
}
)
Estes três pipelines utilizam quatro endpoints, resumidos abaixo.
| Endpoint | Método | Entrada | Saída | Duração máx. |
|---|---|---|---|---|
/v1/videos/generations | POST | Prompt + opções | Novo vídeo | 1-15s |
/v1/videos/edits | POST | Vídeo + prompt | Vídeo modificado | Origem até 8,7s |
/v1/videos/extensions | POST | Vídeo + prompt | Vídeo estendido | +2 a 10s, origem até 15s |
/v1/videos/{id} | GET | request_id | Estado + URL | - |
Tornar uma cadeia resistente a falhas
Assim que encadeia operações, a probabilidade de pelo menos uma falhar torna-se significativa, e uma falha no terceiro elo perde os dois primeiros se nada estiver planeado. A função seguinte encapsula cada passo num ciclo de repetição e só avança para o passo seguinte assim que o URL for obtido.
async def pipeline_with_retry(steps, max_retries=2):
video_url = None
for i, step in enumerate(steps):
for attempt in range(max_retries + 1):
try:
if step["type"] == "generation":
result = await generate_video(step["params"])
elif step["type"] == "extension":
step["params"]["video"] = {"url": video_url}
result = await extend_video(step["params"])
elif step["type"] == "edition":
step["params"]["video"] = {"url": video_url}
result = await edit_video(step["params"])
video_url = await wait_for_result(result["request_id"])
break
except Exception as e:
if attempt == max_retries:
raise Exception(f"Step {i+1} failed: {e}")
await asyncio.sleep(10)
return video_url
Em torno deste esqueleto, cinco hábitos fazem a diferença entre um protótipo e um serviço. Descarregue o resultado em cada passo, uma vez que os URLs são temporários e a recuperação de um incidente exige ter as versões intermédias. Valide visualmente cada segmento antes de prosseguir para o seguinte, caso contrário, paga por três gerações apenas para descobrir que a primeira não era adequada. Trate os erros com tentativas espaçadas por retrocesso exponencial. Calcule o orçamento total antes de lançar uma cadeia longa, contando as iterações prováveis. E paralelize o que puder: no pipeline 2 e no pipeline 3, nenhuma geração depende de outra, pelo que podem correr simultaneamente.
Preços verificados a 3 de novembro de 2026 — os preços mudam regularmente: antes de qualquer cálculo orçamental, verifique as tarifas atuais na página oficial de modelos e preços da xAI.
Pontos-chave
- Os três endpoints (geração, edição, extensão) combinam-se em pipelines
- Imagens de referência garantem consistência estilística em vários vídeos
- A edição iterativa permite derivar um vídeo em várias versões
- Descarregue os resultados intermédios e trate os erros em cada passo
- Calcule o orçamento total antes de lançar pipelines complexos