API Seedance 1.0 Pro: endpoint profissional de geração de vídeo

Se você está incorporando vídeo a um produto, a um fluxo de trabalho ou a um pipeline, a interface web acaba se tornando um gargalo. A API do Seedance 1.0 Pro é o mesmo modelo por trás da interface, exposto como um endpoint REST limpo com autenticação por bearer token, preços previsíveis por segundo e polling de jobs direto ao ponto. Este guia cobre tudo o que você precisa para colocá-la em produção.

Resumo rápido

• API REST para geração de vídeo nativo em 1080p com o Seedance 1.0 Pro
• Autenticação: bearer token gerado no seu painel da conta
• Cobrança: por segundo, a cerca de $0.12/seg, arredondado para cima em créditos inteiros
• Fluxo: enviar job → verificar status → baixar MP4
• Ideal para: integrações SaaS, pipelines em lote, automação, produtos white-label

O que a API oferece

Tudo o que a interface web do Seedance 1.0 Pro disponibiliza, agora de forma programática:

• Geração de imagem para vídeo com uma URL de imagem de origem
• Prompt de movimento para dirigir a animação
• Controle de duração de 2 a 12 segundos
• Controle de frame final para transições dirigidas
• Alternância de câmera travada
• Polling de jobs para status e URL do resultado
• Saída em MP4 em 1080p nativo

Use para produtos SaaS que precisam de geração de vídeo integrada, pipelines internos de agências, fluxos de produção em lote ou automação de tarefas repetitivas de vídeo.

Autenticação

Todas as chamadas de API se autenticam com um bearer token. Gere um no painel da sua conta Arteza em arteza.ai.

Authorization: Bearer YOUR_API_KEY

Regras de segurança:

• Nunca faça commit de chaves de API no controle de versão
• Faça rotação de chaves regularmente
• Use variáveis de ambiente ou um gerenciador de segredos
• Restrinja as chaves a origens específicas sempre que possível

Os endpoints principais

Enviar um job de geração

POST /v1/seedance-1-pro/generate

Corpo da requisição:

{
  "source_image_url": "https://your-cdn.com/source.jpg",
  "prompt": "Slow camera push-in on the subject, warm golden hour light, shallow depth of field",
  "duration_seconds": 6,
  "camera_lock": false,
  "end_frame_url": null
}

Parâmetros:

Resposta:

{
  "job_id": "job_abc123xyz",
  "status": "queued",
  "created_at": "2026-04-10T12:00:00Z",
  "estimated_seconds": 90
}

Verificar o status do job

GET /v1/seedance-1-pro/status/{job_id}

Resposta (em andamento):

{
  "job_id": "job_abc123xyz",
  "status": "processing",
  "progress": 0.45,
  "created_at": "2026-04-10T12:00:00Z"
}

Resposta (concluído):

{
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "resolution": "1920x1080",
  "credits_charged": 144
}

Valores possíveis de status: queued, processing, completed, failed

Baixar o resultado

Quando o status for completed, o video_url aponta para um arquivo MP4 em 1080p. Baixe-o imediatamente e armazene-o na sua própria infraestrutura: não confie que a URL permanecerá válida indefinidamente.

Exemplo completo em Python

import os
import time
import requests

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1/seedance-1-pro"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def generate_video(source_image_url, prompt, duration=6, camera_lock=False, end_frame=None):
    payload = {
        "source_image_url": source_image_url,
        "prompt": prompt,
        "duration_seconds": duration,
        "camera_lock": camera_lock,
    }
    if end_frame:
        payload["end_frame_url"] = end_frame
    
    response = requests.post(f"{BASE_URL}/generate", headers=HEADERS, json=payload)
    response.raise_for_status()
    return response.json()["job_id"]

def wait_for_completion(job_id, poll_interval=5, timeout=300):
    start = time.time()
    while time.time() - start < timeout:
        r = requests.get(f"{BASE_URL}/status/{job_id}", headers=HEADERS)
        r.raise_for_status()
        data = r.json()
        
        if data["status"] == "completed":
            return data["video_url"]
        if data["status"] == "failed":
            raise RuntimeError(f"Job falhou: {data.get('error', 'desconhecido')}")
        
        time.sleep(poll_interval)
    
    raise TimeoutError(f"Job {job_id} não foi concluído em {timeout}s")

def download_video(url, output_path):
    response = requests.get(url, stream=True)
    response.raise_for_status()
    with open(output_path, "wb") as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)

# Use assim
job_id = generate_video(
    source_image_url="https://example.com/product.jpg",
    prompt="Slow camera orbit around the product, studio lighting, 6 seconds",
    duration=6,
    camera_lock=True
)

video_url = wait_for_completion(job_id)
download_video(video_url, "output.mp4")
print(f"Vídeo salvo em output.mp4")

Exemplo completo em Node.js

import fs from 'fs';
import fetch from 'node-fetch';

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1/seedance-1-pro';
const HEADERS = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
};

async function generateVideo(opts) {
  const response = await fetch(`${BASE_URL}/generate`, {
    method: 'POST',
    headers: HEADERS,
    body: JSON.stringify(opts)
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  const data = await response.json();
  return data.job_id;
}

async function waitForCompletion(jobId, { pollInterval = 5000, timeout = 300000 } = {}) {
  const start = Date.now();
  while (Date.now() - start < timeout) {
    const r = await fetch(`${BASE_URL}/status/${jobId}`, { headers: HEADERS });
    const data = await r.json();
    if (data.status === 'completed') return data.video_url;
    if (data.status === 'failed') throw new Error(`Job falhou: ${data.error}`);
    await new Promise(res => setTimeout(res, pollInterval));
  }
  throw new Error('Timeout');
}

async function downloadVideo(url, path) {
  const response = await fetch(url);
  const buffer = await response.buffer();
  fs.writeFileSync(path, buffer);
}

// Use assim
const jobId = await generateVideo({
  source_image_url: 'https://example.com/product.jpg',
  prompt: 'Slow camera orbit around the product, studio lighting, 6 seconds',
  duration_seconds: 6,
  camera_lock: true
});

const videoUrl = await waitForCompletion(jobId);
await downloadVideo(videoUrl, 'output.mp4');
console.log('Arquivo output.mp4 salvo');

Quer qualidade de transmissão assim? Experimente o Seedance 1.0 Pro gratuitamente →

Preços e cobrança

Tarifa: cerca de $0.12 por segundo de vídeo gerado, arredondado para cima ao crédito inteiro mais próximo

Os créditos são debitados apenas em gerações bem-sucedidas. Jobs com falha não consomem créditos.

Os planos são os mesmos da interface web: Starter por $5, Creator por $25, Pro por $50, Studio por $120. Consulte o página de preços.

Limites de taxa e concorrência

Contas padrão têm limites de taxa adequados para cargas de trabalho típicas de integração. Para produção em alto volume, entre em contato com o suporte para limites elevados.

Orientações gerais:

• 5 a 10 jobs simultâneos são confiáveis para a maioria das contas
• Backoff exponencial em respostas HTTP 429
• Tentativas em nível de job em falhas transitórias (até 3 tentativas)
• Callbacks por webhook estão disponíveis para evitar polling excessivo

Webhooks (opcional)

Em vez de fazer polling, registre uma URL de webhook nas configurações da sua conta ou por requisição. Quando um job é concluído, o Arteza envia um POST para a sua URL:

{
  "event": "job.completed",
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "credits_charged": 144,
  "timestamp": "2026-04-10T12:02:15Z"
}

Os webhooks são assinados com uma assinatura HMAC no cabeçalho X-Seedance-Signature. Verifique antes de confiar no payload.

Tratamento de erros

A API retorna códigos de status HTTP padrão:

Os corpos de resposta de erro incluem um campo error com uma mensagem legível e um campo code para tratamento programático.

{
  "error": "Source image URL could not be fetched",
  "code": "source_image_unreachable"
}

Requisitos da imagem de entrada

• Formatos: PNG, JPEG, WebP
• Tamanho: até 10 MB por imagem
• Resolução: mínimo de 512x512, quanto maior melhor (recomenda-se 1080p ou superior)
• Acesso à URL: deve ser publicamente acessível pelos servidores do Arteza (sem localhost, sem autenticação obrigatória)

Para imagens privadas, faça o upload para uma URL assinada do S3, CloudFront ou similar, e passe a URL assinada na requisição.

Boas práticas

1. Armazene os resultados na sua própria infraestrutura. Não dependa das URLs do Arteza a longo prazo.
2. Registre tudo. IDs de jobs, prompts, tempos, transições de status, erros.
3. Tente novamente em erros transitórios. Falhas de rede e respostas 5xx devem ser repetidas com backoff exponencial.
4. Valide as entradas cedo. Verifique URLs de imagens e intervalos de parâmetros antes de enviar.
5. Monitore o saldo de créditos. Configure alertas quando cair abaixo de um limite.
6. Use webhooks em produção. O polling funciona para cargas pequenas, mas é ineficiente em escala.
7. Faça cache de gerações idênticas. Se um usuário enviar a mesma imagem e prompt duas vezes, retorne a URL em cache.

Testes e ambiente de homologação

Comece toda integração no plano Starter por $5 (60 créditos por mês). Isso é suficiente para vinte gerações de teste de 2 segundos. Construa e teste sua integração de ponta a ponta antes de migrar para um plano de maior volume.

Casos de uso

• Plataformas SaaS: permita que seus usuários gerem vídeos a partir dos próprios assets
• E-commerce: gere vídeos de movimento de produtos a partir de imagens do catálogo
• Imóveis: automatize a produção de vídeos de listagem a partir de fotos
• Automação de marketing: vídeos personalizados em escala
• Plataformas de conteúdo: enriqueça artigos, listagens ou publicações em redes sociais com vídeos gerados
• Ferramentas de vídeo white-label: construa seu próprio produto de vídeo com IA sobre o backend do Arteza

Leitura relacionada

• Fluxos de trabalho em processamento em lote
• Guia completo do Seedance 1.0 Pro
• Seedance 1.0 Pro para agências
• Guia da API do Seedance 2.0

Perguntas frequentes

Posso usar a API para aplicações comerciais? Sim, todos os resultados são liberados para uso comercial.

O que acontece se a geração falhar? Nenhum crédito é cobrado em gerações com falha.

Por quanto tempo os vídeos gerados ficam hospedados? Os vídeos ficam disponíveis para download durante uma janela de tempo após a geração. Baixe e armazene imediatamente.

Vocês oferecem bibliotecas SDK? SDKs da comunidade para Python e Node estão disponíveis. Consulte a documentação para desenvolvedores em arteza.ai.

Posso cancelar um job em andamento? Sim, envie DELETE /v1/seedance-1-pro/jobs/{job_id}. Créditos não são cobrados em jobs cancelados.

Como obtenho suporte? Envie um e-mail pelo painel da sua conta para questões específicas da API.

---

A API do Seedance 1.0 Pro é o caminho pronto para produção para incorporar geração de vídeo com IA em 1080p ao seu produto ou pipeline.

Obtenha sua chave de API e comece a criar → com créditos gratuitos 10 incluídos no cadastro.