Preços da API da Luma: documentação do Ray 3.2 e custo por clipe

Um único clipe de 5 segundos em 720p do Ray 3.2 custa US$ 0,30 na API da Luma. Leve o mesmo clipe para 1080p e o preço sobe para US$ 1,20. Acrescente a exportação HDR e EXR em 1080p e uma única tomada de cinco segundos custa US$ 3,60. Esses números vêm direto da página de preços da própria Luma e definem se um projeto de 200 clipes custa o preço de um almoço ou o preço de um notebook. Este artigo detalha cada tarifa do Ray 3.2, percorre a documentação da API para que você envie uma primeira requisição, aponta as combinações de parâmetros que a API rejeita e mostra como manter a conta baixa. Se preferir não escrever código, há também uma seção sobre como usar o Ray 3.2 no PicassoIA pelo navegador.

💡 A Luma afirma que as tarifas de vídeo estão sujeitas a alterações antes da disponibilidade geral. Consulte de novo a página de preços em docs.agents.lumalabs.ai antes de fechar um orçamento.

Preços da API do Ray 3.2 de relance

A Luma cobra o Ray 3.2 pela duração do clipe e pela qualidade de saída, não pela contagem de tokens. Cada geração cai em um bloco fixo de 5 ou 10 segundos, e o preço sobe com a resolução e a faixa dinâmica. Texto para vídeo e imagem para vídeo compartilham a mesma tabela de tarifas, então um clipe animado a partir de uma foto custa o mesmo que um escrito a partir de um prompt.

Tarifas de faixa dinâmica padrão

A faixa dinâmica padrão (SDR) é a saída padrão, e é a tarifa que a maioria dos projetos paga.

O salto de 720p para 1080p merece um segundo olhar. Um quadro em 1080p tem 2,25 vezes os pixels de um quadro em 720p, mas o preço sobe 4 vezes. A menos que o destino realmente exiba 1080p, a faixa mais barata é o padrão mais inteligente.

Tarifas de exportação HDR e EXR

O HDR é limitado a clipes de 5 segundos em 720p ou 1080p. A exportação EXR, o arquivo de cor bruta para a correção de cor profissional, se soma ao HDR.

O HDR dobra o preço do SDR, e adicionar EXR o triplica. Se o clipe vai para o Instagram ou para uma landing page, nada na cadeia de visualização vai mostrar a faixa extra, então dispense HDR e EXR e pague um terço.

Tarifas de reenquadramento e extensão

Duas outras operações têm tarifas próprias, ambas apenas para faixa dinâmica padrão.

• Reenquadramento (mudar a proporção de um vídeo existente) é cobrado por segundo: US$ 0,03 em 360p, US$ 0,06 em 540p, US$ 0,12 em 720p e US$ 0,36 em 1080p.
• Extensão a partir de um único quadro âncora é cobrada como um bloco de 5 segundos: US$ 0,15 em 540p, US$ 0,30 em 720p e US$ 1,20 em 1080p.
• Edição de vídeo tem tarifas separadas de SDR, HDR e HDR + EXR, com faixas de 5 e 10 segundos, todas com tarifas base mais altas que a geração simples. Leia os valores exatos de edição na página de preços.

Aqui há um número que vale guardar. Reenquadrar um clipe de 5 segundos em 720p custa 5 × US$ 0,12 = US$ 0,60. Gerar um clipe novo nativamente em 9:16 custa US$ 0,30. Se você só precisa da versão vertical e não da tomada original exata, gere já na proporção certa.

Quanto custa um clipe de verdade

Custo por segundo em cada faixa

Dividir cada bloco pela sua duração gera um número mais fácil de comparar com outras ferramentas de vídeo.

Um minuto de material finalizado feito com doze clipes de 5 segundos custa US$ 3,60 em 720p e US$ 14,40 em 1080p. Isso pressupõe que você mantenha todas as tomadas, o que ninguém faz.

Dois clipes de 5 segundos superam um de 10

Um clipe de 10 segundos em 720p custa US$ 0,90. Dois clipes de 5 segundos custam US$ 0,60. Isso torna o bloco mais longo 50% mais caro por segundo, e o mesmo padrão vale em todas as resoluções. Em 1080p a diferença é de US$ 3,60 contra US$ 2,40.

A opção de 10 segundos também vem com restrições. A API rejeita 10s junto com HDR, quadro inicial, quadro final ou loop. Por isso, a rota mais barata costuma ser também a mais flexível. Gere o primeiro clipe, pegue o último quadro e envie essa imagem como quadro inicial do segundo clipe, para que o movimento continue sem um salto visível.

Exemplos de orçamento

Agora some a parte que a maioria dos orçamentos esquece. Se você mantém uma tomada em cada três, multiplique por três. O canal semanal com 100 clipes aproveitados vira 300 gerações, ou US$ 90 em vez de US$ 30.

Inclua esse multiplicador em toda estimativa que enviar a um cliente. Um preço fixo por clipe parece barato até que um diretor peça a quarta variação da mesma tomada. Acompanhe os clipes aceitos contra os clipes gerados durante a primeira semana, e você terá uma taxa real de refação. Esse único número torna realistas todas as previsões seguintes.

Passo a passo da documentação da API do Ray 3.2

A Luma publica o Ray 3.2 pela documentação da sua API de Agentes. Três coisas importam antes da primeira chamada: a URL base, o cabeçalho de autenticação e o formato da requisição.

URL base e autenticação

A URL base é https://agents.lumalabs.ai/v1. A autenticação usa um token bearer no cabeçalho Authorization. Guarde o token em uma variável de ambiente e nunca o inclua em um repositório. Existem SDKs oficiais para Python e TypeScript (ambos chamados luma-agents) e para Go (luma-agents-go), além de uma ferramenta de linha de comando.

A requisição de geração

Tudo começa com POST /v1/generations. Três campos são obrigatórios:

• model: definido como "ray-3.2"
• type: definido como "video"
• prompt: de 1 a 6.000 caracteres descrevendo sujeito, movimento, movimento de câmera, iluminação e ritmo

Campos opcionais ajustam a saída. aspect_ratio aceita 9:16, 3:4, 1:1, 4:3, 16:9 ou 21:9. O objeto video recebe resolution (360p, 540p, 720p por padrão, ou 1080p), duration ("5s" por padrão ou "10s"), além de dois booleanos, hdr e loop.

curl https://agents.lumalabs.ai/v1/generations \
  -H "Authorization: Bearer $LUMA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ray-3.2",
    "type": "video",
    "prompt": "Slow dolly shot through a misty greenhouse at sunrise",
    "aspect_ratio": "16:9",
    "video": { "resolution": "720p", "duration": "5s" }
  }'

Copiar prompt

Essa requisição custa US$ 0,30: 720p, 5 segundos, faixa dinâmica padrão.

Consultando o status do job

Um envio bem-sucedido retorna HTTP 201 com o estado queued. Consulte GET /v1/generations/{id} até o job chegar a um estado final, seja sucesso ou failed. Em caso de sucesso, a saída inclui uma URL pré-assinada para o MP4. Links pré-assinados são temporários por definição, então copie o arquivo para o seu armazenamento imediatamente.

Conte com cerca de 80 a 200 segundos por clipe. Os exemplos executados na página do Ray 3.2 do PicassoIA levaram entre 79 e 204 segundos, então consultar a cada 5 a 10 segundos é suficiente.

Regras de parâmetros que geram erros

Uma requisição rejeitada desperdiça uma ida e volta, e uma regra mal compreendida desperdiça uma tarde. A documentação da Luma detalha quais opções não podem ser combinadas.

Conflitos de HDR, loop e 10s

Valide essas regras no seu próprio código antes de chamar a API. Uma pequena função que verifica a combinação leva dez minutos para escrever e elimina uma classe inteira de jobs com falha.

Limites de taxa e erros 429

Dois limites independentes se aplicam a POST /v1/generations:

1. Requisições por minuto (RPM): o número máximo de requisições em uma janela deslizante de 60 segundos.
2. Jobs simultâneos: o número máximo de gerações ativas a qualquer momento.

A Luma não publica números exatos. Seus limites dependem do seu plano e aparecem no painel da plataforma Luma. Ambos os limites retornam HTTP 429, e o corpo da resposta os diferencia.

Dimensione um semáforo no seu worker de acordo com o limite de concorrência mostrado no seu painel, e respeite Retry-After em vez de tentar de novo em um intervalo fixo. Distribua um lote grande ao longo do minuto em vez de disparar todas as requisições de uma vez, e a janela de RPM deixa de ser um problema.

Formas de manter a conta baixa

Rascunho em 360p primeiro

A faixa de rascunho em 360p custa US$ 0,06, um quinto de um clipe em 720p e um vigésimo de um clipe em 1080p. Teste cada prompt ali e promova só os vencedores.

Imagine que você precisa de 25 tomadas em 1080p. Renderizar as 25 direto em 1080p custa US$ 30,00. Renderizar 20 rascunhos (US$ 1,20) e promover 5 vencedoras para 1080p (US$ 6,00) custa US$ 7,20, uma economia de 76%.

Um cuidado: um rascunho é uma geração separada, então trate-o como um teste do prompt e da ideia de movimento, não como uma prévia exata em pixels. Verifique se uma nova renderização mantém a mesma tomada antes de planejar um pipeline em cima disso.

💡 Coloque um limite rígido de tentativas no seu worker: três tentativas, depois pare e registre o prompt. Um loop que reenvia a cada falha transforma um erro de US$ 0,30 em uma fatura de verdade.

Combine a resolução com o destino

Defina aspect_ratio no momento da geração, em vez de reenquadrar depois, e use a flag loop para clipes de fundo, em vez de montar um loop manualmente.

Ray 3.2 sem escrever código

A API serve a um produto ou a um pipeline agendado. Para um projeto pontual, uma interface no navegador elimina o tratamento de token, o loop de consulta e o código de limite de taxa. O PicassoIA hospeda o Ray 3.2, então você escolhe as configurações em um formulário e baixa o MP4.

O PicassoIA também tem sua própria API no estilo Replicate. No momento em que escrevo, ela expõe quatro modelos do PicassoIA, incluindo PicassoIA Video e Seedance 2.5 Lite. O Ray 3.2 não está nessa lista, então ele continua na interface web.

O que o PicassoIA oferece

As mesmas regras de combinação da API da Luma se aplicam. Uma diferença: o formulário do PicassoIA não lista a faixa de rascunho em 360p. Verifique o seu plano no PicassoIA para saber como as gerações do Ray 3.2 são contabilizadas.

Como usar o Ray 3.2 no PicassoIA

1. Abra a página do modelo Ray 3.2.
2. Escreva um prompt que indique o sujeito, o movimento, o movimento de câmera, a iluminação e o ritmo.
3. Comece em 720p e 5 segundos enquanto testa.
4. Escolha uma proporção ou envie uma imagem inicial para animar uma foto.
5. Ative HDR ou loop somente se as regras acima permitirem.
6. Gere, revise o clipe, ajuste o prompt e execute de novo. Quando o movimento estiver certo, renderize novamente em 1080p.

Um prompt que funciona bem na página do modelo: "Travelling cinematográfico lento através de uma estufa enevoada ao amanhecer, raios de sol dourados filtrados pela condensação em painéis de vidro antigo, samambaias e orquídeas exuberantes, reflexos de lente anamórfica."

Alternativas mais baratas e gratuitas

O Ray 3.2 não é a única forma de obter movimento cinematográfico, e a US$ 1,20 por tomada em 1080p nem sempre é a mais barata. Estes modelos do PicassoIA fazem os mesmos trabalhos de texto para vídeo e imagem para vídeo:

Uma divisão prática: prototipe em um modelo gratuito e gaste os créditos do Ray 3.2 nas tomadas que precisam de HDR, EXR ou do quadro 21:9. O PicassoIA também lista as categorias de aumento de resolução e super resolução de vídeo na sua página de todos os modelos. Vale testar se um clipe do Ray 3.2 em 720p, com aumento de resolução, atinge o seu padrão de qualidade antes de pagar a taxa de 4× por 1080p nativo.

Gere seu primeiro clipe hoje

Os números são simples quando ficam lado a lado. 720p custa US$ 0,30, 1080p custa US$ 1,20, HDR dobra o preço, EXR o triplica, e dois clipes de 5 segundos superam um de 10 segundos. Rascunhe em 360p, gere na proporção que você precisa e limite suas tentativas.

Abra o Ray 3.2 no PicassoIA, execute um prompt em 720p e depois envie exatamente o mesmo prompt para o Ray Flash 2 720p e para o Seedance 2.5 Lite. Três clipes lado a lado vão dizer mais sobre preço versus qualidade do que qualquer tabela de tarifas. Crie o seu agora em picassoia.com.