API Seedance 2.0 Fast: endpoint de geração de vídeo econômico

Uma requisição HTTP, um clipe de vídeo com qualidade cinematográfica, $1,94. Essa é a economia unitária de construir sobre a API Seedance 2.0 Fast. Endpoints dedicados para texto-para-vídeo e imagem-para-vídeo, precificação determinística, o mesmo motor de qualidade do Seedance 2.0 padrão e uma vantagem de custo de ~20% que faz diferença quando você opera em escala.

Aqui está o guia completo para desenvolvedores.

Resumo rápido

• Endpoints: bytedance/seedance-2.0/fast/text-to-video e fast/image-to-video
• Custo: $0,2419 por segundo, ou 10-55 créditos por clipe ($1,00-$5,50)
• Resposta: ID de job assíncrono, consulte o status e baixe o MP4
• Autenticação: Chave de API gerada no seu Arteza dashboard
• Velocidade: 30-150 segundos por geração

Para que serve a API Fast

Se você está desenvolvendo um app, ferramenta ou serviço que gera vídeos para usuários, seja um agendador de redes sociais, plataforma de automação de marketing, motor de conteúdo para e-commerce ou ferramenta criativa interna, a API Seedance 2.0 Fast é o endpoint mais barato com qualidade cinematográfica disponível para desenvolver em 2026.

Mesma qualidade visual do Seedance 2.0 padrão. Custo menor por segundo. Maior capacidade de processamento. Feito para integração em fluxos de trabalho que produzem vídeo em volume.

O perfil típico de usuário é um desenvolvedor ou equipe que precisa gerar vídeo de forma programática com base na entrada do usuário, e não um criador individual que gera um clipe de cada vez pela interface.

Os dois endpoints

Endpoint de texto-para-vídeo:

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/text-to-video

Gera um vídeo a partir de um prompt de texto. Nenhuma imagem de origem é necessária.

Endpoint de imagem-para-vídeo:

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/image-to-video

Gera um vídeo a partir de uma imagem de origem enviada, com um prompt de movimento.

Ambos os endpoints aceitam corpos de requisição semelhantes e retornam o mesmo formato de resposta. Escolha com base em ter ou não uma imagem de origem para animar.

Autenticação

Cada requisição precisa de uma chave de API no cabeçalho Authorization. Gere uma chave no seu Arteza dashboard.

Authorization: Bearer YOUR_API_KEY

As chaves estão vinculadas à sua conta e consomem do seu saldo de créditos. Rotacione-as conforme necessário pelo painel.

Formato da requisição: texto-para-vídeo

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "Slow dolly in on a ceramic coffee cup on a wooden cafe table, morning window light, shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Parâmetros:

• prompt (obrigatório, string): O prompt de texto descrevendo o vídeo desejado.
• duration (obrigatório, inteiro): Duração do clipe em segundos. Intervalo: 4-15.
• aspect_ratio (obrigatório, string): Um dos valores "16:9", "9:16", "1:1".

Formato da requisição: imagem-para-vídeo

POST /api/v1/bytedance/seedance-2.0/fast/image-to-video
{
  "image_url": "https://your-cdn.com/source-image.jpg",
  "prompt": "Slow push in with shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Parâmetros:

• image_url (obrigatório, string): URL pública da imagem de origem. Formatos suportados: JPG, PNG, WebP.
• prompt (obrigatório, string): Prompt de movimento descrevendo como animar a imagem.
• duration (obrigatório, inteiro): Duração do clipe em segundos. Intervalo: 4-15.
• aspect_ratio (obrigatório, string): Deve corresponder à proporção da imagem de origem para melhores resultados.

Formato da resposta

Ambos os endpoints retornam um ID de job assíncrono:

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "queued",
  "estimated_seconds": 45,
  "cost_credits": 242
}

Consulte o endpoint de status até o job ser concluído:

GET /api/v1/jobs/sdf_2026_abc123xyz

Uma resposta de conclusão:

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/output/sdf_2026_abc123xyz.mp4",
  "duration_seconds": 5,
  "resolution": "720p",
  "credits_consumed": 242
}

Baixe a video_url e você terá o seu MP4.

Exemplo completo em Python

import requests
import time

API_KEY = "your_api_key_here"
BASE_URL = "https://arteza.ai/api/v1"

def generate_fast_video(prompt, duration=5, aspect_ratio="16:9"):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    
    # Submete o job de geração
    response = requests.post(
        f"{BASE_URL}/bytedance/seedance-2.0/fast/text-to-video",
        headers=headers,
        json={
            "prompt": prompt,
            "duration": duration,
            "aspect_ratio": aspect_ratio
        }
    )
    job = response.json()
    job_id = job["job_id"]
    print(f"Job na fila: {job_id}, estimativa de {job['estimated_seconds']}s")
    
    # Consulta até a conclusão
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Concluído: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Geração falhou: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

# Uso
video_url = generate_fast_video(
    "Slow tracking shot of a golden retriever running through autumn leaves, golden hour, cinematic 35mm film look",
    duration=5,
    aspect_ratio="16:9"
)

Exemplo completo em JavaScript

const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://arteza.ai/api/v1';

async function generateFastVideo(prompt, duration = 5, aspectRatio = '16:9') {
  const headers = {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  };

  // Submete o job de geração
  const submitRes = await fetch(
    `${BASE_URL}/bytedance/seedance-2.0/fast/text-to-video`,
    {
      method: 'POST',
      headers,
      body: JSON.stringify({ prompt, duration, aspect_ratio: aspectRatio })
    }
  );
  const job = await submitRes.json();
  console.log(`Job na fila: ${job.job_id}`);

  // Consulta até a conclusão
  while (true) {
    await new Promise(r => setTimeout(r, 10000));
    const statusRes = await fetch(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers }
    );
    const status = await statusRes.json();

    if (status.status === 'completed') {
      return status.video_url;
    } else if (status.status === 'failed') {
      throw new Error(`Geração falhou: ${status.error}`);
    }
  }
}

// Uso
const videoUrl = await generateFastVideo(
  'Slow dolly in on a matcha latte in a ceramic cup, morning window light, cinematic 35mm',
  5,
  '9:16'
);

Pronto para desenvolver na API? Obtenha sua chave de API →

Precificação por chamada de API

Cada chamada de API desconta créditos do seu saldo com base na duração:

Os créditos não expiram. Compre em volume pelo níveis de crédito para uma economia melhor por chamada. O plano Enterprise reduz o custo efetivo em ~17%.

Limites de taxa e capacidade

A API Seedance 2.0 Fast permite o envio de jobs simultâneos dentro de limites razoáveis. Contas comuns conseguem enviar 5-10 jobs em paralelo sem atingir restrições. Contas do plano Enterprise podem solicitar maior concorrência.

Jobs de geração individuais levam 30-150 segundos dependendo da duração. Com 5 jobs simultâneos, é possível produzir um clipe a cada ~15-30 segundos de tempo real.

Para geração em lote (50+ clipes), envie em ondas de 5-10, aguarde a conclusão e envie a próxima onda. Não sobrecarregue a API com centenas de requisições simultâneas.

Tratamento de erros

Respostas de erro mais comuns:

400 Bad Request: Parâmetros inválidos. Verifique o intervalo de duração, os valores de proporção e o comprimento do prompt.

401 Unauthorized: Chave de API ausente ou inválida.

402 Payment Required: Créditos insuficientes. Recarregue pelo painel.

429 Too Many Requests: Limite de taxa excedido. Aguarde e tente novamente.

500 Internal Server Error: Problema temporário no servidor. Tente novamente com espera exponencial.

Implemente sua integração para tratar os erros 429 e 500 de forma elegante com lógica de tentativas. Um backoff exponencial simples (1s, 2s, 4s, 8s) resolve a maioria das falhas transitórias.

Fast vs. padrão no contexto da API

A escolha entre os endpoints Fast e padrão é principalmente econômica:

• Use o Fast para geração programática em alto volume, apps sensíveis a custo e tudo que não for um clipe principal.
• Use o padrão para conteúdo de destaque onde a pequena vantagem de qualidade justifica o prêmio de custo de 20%.

A maioria dos apps usa o Fast como padrão. O endpoint padrão costuma ser reservado para funcionalidades de "tier premium" ou solicitações específicas do usuário.

URLs dos endpoints:

• Fast texto: bytedance/seedance-2.0/fast/text-to-video
• Fast imagem: bytedance/seedance-2.0/fast/image-to-video
• Padrão texto: bytedance/seedance-2.0/text-to-video
• Padrão imagem: bytedance/seedance-2.0/image-to-video

Suporte a webhooks

Para jobs de longa duração, fazer polling é ineficiente. A API Seedance 2.0 Fast suporta callbacks via webhook. Inclua um webhook_url no corpo da requisição e você receberá um POST quando o job for concluído:

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "...",
  "duration": 5,
  "aspect_ratio": "16:9",
  "webhook_url": "https://your-app.com/api/seedance-callback"
}

Seu endpoint de webhook recebe o mesmo payload JSON que o endpoint de status retornaria na conclusão. Implemente idempotência, pois os webhooks podem ser reenviados em caso de falha.

Perguntas comuns e respostas rápidas

Qual é o número máximo de jobs simultâneos que posso enviar? Contas comuns: 5-10. Enterprise: negociável.

Os créditos são descontados em jobs com falha? Não. Jobs com falha devolvem os créditos automaticamente.

Posso cancelar um job em andamento? Sim, via POST /api/v1/jobs/{job_id}/cancel. Os créditos são devolvidos se o cancelamento ocorrer antes da conclusão.

Qual é o formato do arquivo de saída? MP4, vídeo H.264, áudio AAC, resolução 720p.

Por quanto tempo as URLs de saída permanecem válidas? As URLs do CDN de saída são válidas por 7 dias. Baixe-as e armazene no seu próprio sistema para uso de longo prazo.

Existe um modo sandbox ou de teste? Não há sandbox dedicado. Use os créditos gratuitos do cadastro 10 para testar. O plano Starter de $5 também é uma forma de baixo risco para desenvolver contra endpoints reais.

Comece a desenvolver na API Seedance 2.0 Fast

A API é intencionalmente simples: dois endpoints, precificação determinística, modelo de job assíncrono e um teto de qualidade equivalente ao nível principal do Seedance 2.0. Desenvolva sobre ela para ferramentas de redes sociais, automação de marketing, plataformas para criadores, motores de conteúdo para e-commerce ou apps criativos internos. A economia unitária finalmente torna a geração de vídeo viável como funcionalidade dentro de outros produtos.

Pronto para desenvolver? Obtenha sua chave de API →

Continue lendo: Guia completo do Seedance 2.0 Fast • Preços do Seedance 2.0 Fast • Criação em lote com Seedance 2.0 Fast