Referência de ferramentas
Você raramente chama esses pelo nome: peça em palavras simples e seu assistente escolhe a ferramenta. Ferramentas que fazem um vídeo gastar créditos e devolver um job_id; o vídeo é renderizado em segundo plano e get_job_status avisa quando está pronto.
create_ad
Seção intitulada “create_ad”Um anúncio multi-cena, a partir de um brief, passando por todo o pipeline do Studio: ele planeja as cenas e depois as renderiza.
| Entrada | ||
|---|---|---|
brief |
Obrigatório | Para que serve: produto, público, ângulo, clima (3-2.000 caracteres). |
scene_count |
Opcional | 2-6 cenas, padrão 4. |
aspect |
Opcional | 16:9 (padrão), 9:16 para Reels, TikTok e Shorts, ou 1:1. |
branded |
Opcional | true aplica o kit de marca salvo na sua conta: logo, cores e cartão final. Se você não tiver nenhum, a chamada para antes de cobrar qualquer coisa. |
product_image_url |
Opcional | Uma imagem pública do produto para destacar. |
title, idempotency_key |
Opcional |
Custos: 1 crédito para o plano, depois a renderização. Se a renderização não puder começar, o crédito de planejamento é reembolsado. Tente: “Faça um comercial vertical de 4 cenas para nosso latte de leite de aveia, quente e aconchegante, com minha marca.”
create_presenter_video
Seção intitulada “create_presenter_video”Um apresentador lê seu roteiro para a câmera. Custos: precificados pelo comprimento do roteiro, mostrado na resposta como credits_charged.
| Entrada | ||
|---|---|---|
script |
Obrigatório | As palavras exatas (5-2.000 caracteres). |
title, idempotency_key |
Opcional |
Tente: “Faça um vídeo de apresentador dizendo: Bem-vindo à equipe, aqui está como agendar seu primeiro turno.”
create_launch_video
Seção intitulada “create_launch_video”Um breve promo de apresentador para um aplicativo ou produto; o roteiro é escrito para você e devolvido junto com o trabalho. Custos: precificados pelo comprimento do roteiro.
| Entrada | ||
|---|---|---|
app_name, description |
Obrigatório | Nome, o que faz e para quem é. |
website_url, idempotency_key |
Opcional |
Tente: “Faça um vídeo de lançamento para Northwind, um aplicativo de orçamento para freelancers.”
get_job_status
Seção intitulada “get_job_status”Grátis. Devolve status (queued, processing, completed ou failed), progress 0-100 e video_url uma vez concluído. Renderizações geralmente levam alguns minutos; uma renderização falhada reembolsa o valor que cobrou. Apenas trabalhos na sua própria conta são visíveis.
get_account
Seção intitulada “get_account”Grátis. Seu nome, e-mail, plano e créditos restantes.