API Seedance 1.0 Lite: Endpoint de Geração Rápida de Vídeos

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

Por que os Desenvolvedores Integram a API

A versão UI do Seedance 1.0 Lite é ótima para geração manual. A API desbloqueía os fluxos de trabalho que o uso manual não consegue suportar:

• Animação de catálogo automatizada - 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, envie para plataformas de anúncios via suas APIs
• Sistemas de geração de conteúdo - alimente imagens do CMS no Arteza e obtenha versões animadas de volta
• Fluxos de trabalho gerados pelo usuário em tempo real - permita que seus usuários façam upload de uma imagem e obtenham uma versão animada
• Jobs em lote - processe centenas de imagens de origem durante a noite

Por $0,14-$0,84 por chamada e retorno de 30-60 segundos, você pode criar automação de vídeo em nível de produção que teria sido economicamente impossível há 18 meses.

Obtendo Acesso à API

1. Cadastre-se em a plataforma - 50 créditos gratuitos chegam imediatamente
2. Navegue para configurações de API no seu painel
3. Gere uma chave de API - armazene-a com segurança (nunca confirme no git)
4. Opcional: Compre um pacote de créditos em a página de preços - $10, $25, $50 ou $100

Seus 50 créditos gratuitos 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 central é uma única requisição POST para o endpoint de geração Seedance 1.0 Lite.

Parâmetros obrigatórios

Parâmetros opcionais

Modelo de resposta

A API retorna um ID de job e status. A geração é assíncrona - verifique a conclusão 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 de token bearer via cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

As chaves de API estão vinculadas à sua conta e cobram contra seu saldo de créditos. Revire as chaves via painel se suspeitar de vazamento.

Exemplo de Código: Python

Aqui está uma integração Python mínima que envia um job, verifica 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"):
    # Submit the 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"]
    
    # Poll for completion
    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"Generation failed: {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"Video ready: {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') {
  // Submit the 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}` },
    }
  );

  // Poll for completion
  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('Video ready:', url));

Padrão de Webhook (Recomendado para Produção)

Polling funciona, mas webhooks são mais limpos em escala. Passe uma webhook_url em sua requisição de geração e a API fará POST no 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 polling. Nenhum loop de polling necessário.

Quer fazer isso você mesmo? Experimente Seedance 1.0 Lite gratuitamente →

Pronto para experimentar Seedance 1.0 Lite? Comece a criar gratuitamente →

Limites de Taxa e Concorrência

Para concorrência ou volume mais altos, entre em contato com o suporte. A plataforma pode suportar cargas de trabalho em lote de 10.000+ jobs/dia em configurações dedicadas.

Tratamento de Erros

Códigos de status HTTP padrão se aplicam:

Para integrações de 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 se usar webhooks
• Chaves de idempotência para evitar cobranças duplicadas em erros de rede

Gerenciamento de Custos em Produção

Cada chamada cobra créditos na taxa padrão: 7 créditos por segundo de vídeo.

Dicas de controle de custos em produção:

• Teste prompts com 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 atingir o limite
• Monitore o campo credits_charged em cada resposta para rastrear gastos por fluxo de trabalho
• Use webhooks para evitar gastar tempo em polling
• Cache de resultados bem-sucedidos quando possível para que requisições idênticas não se regenerem

Padrões de Integração Reais

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

Dispare um job Seedance 1.0 Lite toda vez que um novo SKU for adicionado ao seu catálogo. Escreva a URL MP4 resultante no seu banco de dados de produtos. Exiba em PDPs automaticamente.

Pipeline de criação de anúncios

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

Aplicativos de conteúdo gerado pelo usuário

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

Aprimoramento do CMS

Integre seu CMS para que qualquer nova imagem em destaque obtenha uma versão animada Seedance 1.0 Lite gerada automaticamente. Armazene ambas as versões - estática para fallback, animada para placements em hero.

Atualização de catálogo em lote

Job noturno regenera versões animadas de seus 500 produtos principais com prompts de movimento sazonais. Criativo fresco sem intervenção humana.

Atualizando para Pro ou 2.0 via API

Quando um job específico precisa de qualidade premium, alterne endpoints:

• /seedance-1-lite/generate - $0,14-$0,84, rápido, trabalho em volume
• /seedance-1-pro/generate - $0,48-$2,88, movimento premium, controle de quadro final
• /seedance-2.0/generate - $2,43-$9,10, qualidade de cinema + áudio nativo

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

Comece a Integrar Hoje

Cadastre-se, pegue sua chave de API no painel, e faça sua primeira chamada com os 50 créditos gratuitos. O exemplo Python acima funciona de ponta a ponta em cerca de 45 segundos e oferece um padrão de integração de trabalho para construir.

Obtenha sua chave de API gratuitamente → - 50 créditos no cadastro, sem cartão necessário, integração pronta para produção em menos de uma hora.