API do Seedance 1.0 Lite: endpoint rápido para geração de vídeos

Uma única requisição POST, uma espera de 30-60 segundos e você recebe um MP4 em 1080p. É essa a API completa do Seedance 1.0 Lite. Para desenvolvedores que constroem fluxos de trabalho de vídeo automatizados, seja para animações de produtos em e-commerce, pipelines de criação de anúncios ou sistemas de geração de conteúdo, este é o guia de integração.

Resumo rápido

• Endpoint único de POST recebe imagem + prompt de movimento e retorna um MP4 em 1080p
• Modelo de job assíncrono: envie a requisição, consulte o status e baixe o resultado
• Custo por chamada: $0,20-$1,00 com base na duração (2-12 segundos)
• Latência típica de ponta a ponta: 30-60 segundos
• 10 créditos grátis no cadastro, suficientes para validar a integração antes de se comprometer
• O mesmo pool de créditos funciona em todos os modelos Arteza e Seedream

Por que desenvolvedores integram a API

A versão com interface do Seedance 1.0 Lite é ótima para geração manual. A API desbloqueia fluxos de trabalho que o uso manual não consegue suportar:

• Animação automatizada de catálogo - dispare uma geração para cada novo SKU adicionado ao seu backend de e-commerce
• Pipelines de criação de anúncios - gere variantes em um cronograma e envie para plataformas de anúncios via suas APIs
• Sistemas de geração de conteúdo - alimente imagens do CMS no Arteza e receba versões animadas de volta
• Fluxos gerados pelo usuário em tempo real - permita que seus próprios usuários façam upload de uma imagem e recebam uma versão animada
• Jobs em lote - processe centenas de imagens de origem durante a noite

Com $0,20-$1,00 por chamada e um retorno de 30-60 segundos, você pode construir automação de vídeo em nível de produção que teria sido economicamente inviável há 18 meses.

Como obter acesso à API

1. Cadastre-se em a plataforma - 10 créditos grátis chegam imediatamente
2. Navegue até as configurações de API no seu painel
3. Gere uma chave de API - armazene-a com segurança (nunca faça commit no git)
4. Opcional: escolha um plano mensal em a página de preços - $5, $25, $50 ou $120

Seus 10 créditos grátis também funcionam para chamadas de API. Você pode validar a integração completa antes de pagar qualquer coisa.

O modelo de requisição

A interação principal é um único POST para o endpoint de geração do Seedance 1.0 Lite.

Parâmetros obrigatórios

Parâmetros opcionais

Modelo de resposta

A API retorna um ID de job e o status. A geração é assíncrona: consulte o status periodicamente ou use um webhook.

{
  "job_id": "sd1lite_abc123xyz",
  "status": "processing",
  "credits_charged": 42,
  "estimated_time_seconds": 45,
  "created_at": "2026-04-10T12:00:00Z"
}

Quando concluído:

{
  "job_id": "sd1lite_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/...",
  "duration_seconds": 6,
  "resolution": "1080p",
  "credits_charged": 42,
  "completed_at": "2026-04-10T12:00:45Z"
}

Autenticação

Todas as requisições usam autenticação por token bearer via o cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

As chaves de API estão vinculadas à sua conta e debitam do seu saldo de créditos. Regenere as chaves pelo painel caso suspeite de vazamento.

Exemplo de código: Python

Aqui está uma integração Python mínima que envia um job, consulta o status até a conclusão e baixa o resultado.

import requests
import time
import os

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1"

def generate_video(image_url, prompt, duration=6, aspect="9:16"):
    # Envia o job
    response = requests.post(
        f"{BASE_URL}/seedance-1-lite/generate",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "image": image_url,
            "prompt": prompt,
            "duration": duration,
            "resolution": "1080p",
            "aspect_ratio": aspect,
            "camera_lock": True,
        },
    )
    job = response.json()
    job_id = job["job_id"]
    
    # Consulta o status até a conclusão
    while True:
        status_response = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        )
        status = status_response.json()
        if status["status"] == "completed":
            return status["video_url"]
        if status["status"] == "failed":
            raise Exception(f"Geração falhou: {status.get('error')}")
        time.sleep(5)

video_url = generate_video(
    image_url="https://example.com/product.jpg",
    prompt="Product rotates smoothly, highlights catch across the surface, camera completely locked",
    duration=6,
    aspect="1:1",
)
print(f"Vídeo pronto: {video_url}")

Exemplo de código: Node.js

const axios = require('axios');

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1';

async function generateVideo(imageUrl, prompt, duration = 6, aspect = '9:16') {
  // Envia o job
  const { data: job } = await axios.post(
    `${BASE_URL}/seedance-1-lite/generate`,
    {
      image: imageUrl,
      prompt,
      duration,
      resolution: '1080p',
      aspect_ratio: aspect,
      camera_lock: true,
    },
    {
      headers: { Authorization: `Bearer ${API_KEY}` },
    }
  );

  // Consulta o status até a conclusão
  while (true) {
    const { data: status } = await axios.get(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } }
    );

    if (status.status === 'completed') return status.video_url;
    if (status.status === 'failed') throw new Error(status.error);

    await new Promise((r) => setTimeout(r, 5000));
  }
}

generateVideo(
  'https://example.com/product.jpg',
  'Product rotates smoothly, highlights catch across the surface, camera completely locked',
  6,
  '1:1'
).then((url) => console.log('Vídeo pronto:', url));

Padrão de webhook (recomendado para produção)

A consulta periódica funciona, mas webhooks são mais elegantes em escala. Passe um webhook_url na sua requisição de geração e a API enviará um POST com o payload de conclusão quando o job terminar.

response = requests.post(
    f"{BASE_URL}/seedance-1-lite/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "image": image_url,
        "prompt": prompt,
        "duration": 6,
        "webhook_url": "https://your-app.com/webhooks/seedance",
    },
)

Seu handler de webhook recebe o mesmo JSON de conclusão que o endpoint de consulta. Nenhum loop de polling necessário.

Quer criar isso você mesmo? Experimente o Seedance 1.0 Lite grátis →

Pronto para experimentar o Seedance 1.0 Lite? Comece a criar grátis →

Limites de taxa e concorrência

Para maior concorrência ou volume, entre em contato com o suporte. A plataforma suporta cargas de trabalho em lote de mais de 10.000 jobs por dia em configurações dedicadas.

Tratamento de erros

Os códigos de status HTTP padrão se aplicam:

Para integrações em produção, sempre implemente:

• Backoff exponencial para erros 429 e 500
• Verificações de saldo de créditos antes de grandes execuções em lote
• Validação de assinatura de webhook ao usar webhooks
• Chaves de idempotência para evitar cobranças duplicadas em erros de rede

Gestão de custos em produção

Cada chamada debita créditos por duração: 2 créditos para um clipe de 2-3 segundos, chegando a 7 créditos em 12 segundos.

Dicas de controle de custos em produção:

• Teste prompts a 2 segundos antes de se comprometer com execuções em lote de 12 segundos
• Defina um orçamento mensal de créditos e faça seu código parar quando ele for atingido
• Monitore o campo credits_charged em cada resposta para rastrear os gastos por fluxo de trabalho
• Use webhooks para evitar desperdiçar tempo com polling
• Armazene em cache os resultados bem-sucedidos sempre que possível para que requisições idênticas não sejam regeneradas

Padrões reais de integração

Animação de catálogo de e-commerce

Dispare um job do Seedance 1.0 Lite sempre que um novo SKU for adicionado ao seu catálogo. Grave a URL do MP4 resultante no seu banco de dados de produtos. Exiba automaticamente nas páginas de detalhe do produto.

Pipeline de criação de anúncios

Um job cron diário gera 10 novas variantes de anúncios a partir de diferentes imagens de origem. Envia os MP4s diretamente para a API do Meta Ads como novos criativos. Fecha o ciclo entre a geração de conteúdo e a entrega de anúncios.

Aplicativos de conteúdo gerado pelo usuário

Permita que os usuários façam upload de uma foto no seu aplicativo. Seu backend chama o Seedance 1.0 Lite com um prompt padronizado. Retorne a versão animada ao usuário em menos de um minuto. Cobre dos usuários o suficiente para cobrir o custo de API de cerca de $0.20 com uma margem saudável.

Aprimoramento de CMS

Conecte ao seu CMS para que qualquer nova imagem em destaque receba automaticamente uma versão animada gerada pelo Seedance 1.0 Lite. Armazene as duas versões: estática como fallback e animada para posicionamentos de destaque.

Atualização em lote de catálogo

Um job noturno regenera versões animadas dos seus 500 produtos mais importantes com prompts de movimento sazonais. Criativo sempre atualizado sem intervenção humana.

Fazendo upgrade para Pro ou 2.0 via API

Quando um job específico precisar de qualidade premium, troque de endpoint:

• /seedance-1-lite/generate - $0,20-$1,00, rápido, para grande volume
• /seedance-1-pro/generate - $0,20-$1,00, movimento premium, controle de frame final
• /seedance-2.0/generate - $1.20-$4.40, qualidade cinematográfica com áudio nativo

Mesma chave de API, mesmo pool de créditos, mesma autenticação. Troque de modelo chamando um endpoint diferente. Veja o guia de comparação Pro para saber quando fazer upgrade.

Comece a integrar hoje

Cadastre-se, obtenha sua chave de API no painel e faça sua primeira chamada com os 10 créditos grátis. O exemplo Python acima roda de ponta a ponta em cerca de 45 segundos e fornece um padrão de integração funcional para você construir em cima.

Obtenha sua chave de API grátis → - 10 créditos no cadastro, sem necessidade de cartão, integração pronta para produção em menos de uma hora.