Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Combinar edição e extensão

Aula 9 de 12 Atualizada a 3 de novembro de 2026 Intermediario
Nesta página
  1. Pipelines de produção avançados
  2. Pipeline 1: Um spot publicitário de produto de 15 segundos
  3. Pipeline 2: Cinco conteúdos, um estilo
  4. Pipeline 3: Derivar variantes a partir de um vídeo
  5. Tornar uma cadeia resistente a falhas
  6. Pontos-chave

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 objeto video ({"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.

EndpointMétodoEntradaSaídaDuração máx.
/v1/videos/generationsPOSTPrompt + opçõesNovo vídeo1-15s
/v1/videos/editsPOSTVídeo + promptVídeo modificadoOrigem até 8,7s
/v1/videos/extensionsPOSTVídeo + promptVídeo estendido+2 a 10s, origem até 15s
/v1/videos/{id}GETrequest_idEstado + 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