Seedance 2.0 Fast API: Endpoint de Geração de Vídeo em Orçamento

Uma solicitação HTTP, um clipe de vídeo AI de qualidade cinematográfica, $1.94. Essa é a economia unitária de construir sobre a Seedance 2.0 Fast API. Endpoints dedicados para text-to-video e image-to-video, preços determinísticos, mesmo mecanismo de qualidade da Seedance 2.0 standard, e uma vantagem de custo de ~20% que importa quando você está operando em escala.

Aqui está o guia completo do desenvolvedor.

Para O Que A Fast API É

Se você está construindo um app, ferramenta ou serviço que gera vídeo para usuários - agendador de redes sociais, plataforma de automação de marketing, mecanismo de conteúdo de e-commerce, ferramenta criativa interna - a Seedance 2.0 Fast API é o endpoint de qualidade cinematográfica mais barato que você pode construir em 2026.

Mesma qualidade visual que Seedance 2.0 standard. Custo menor por segundo. Throughput de computação maior. Construída para integração em workflows que produzem vídeo em volume.

O usuário alvo típico é um desenvolvedor ou time que precisa gerar vídeo programaticamente com base em entrada do usuário - não um criador único gerando um clipe por vez através da UI.

Os Dois Endpoints

Endpoint text-to-video:

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 image-to-video:

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 carregada com um prompt de movimento.

Ambos os endpoints aceitam corpos de solicitação similares e retornam o mesmo formato de resposta. Escolha com base em se você tem uma imagem de origem para animar.

Autenticação

Cada solicitação precisa de uma chave API no header Authorization. Gere uma chave do seu painel Arteza.

Authorization: Bearer YOUR_API_KEY

As chaves estão vinculadas à sua conta e descontam do seu saldo de créditos. Rotacione-as conforme necessário através do dashboard.

Formato de Solicitação: Text-To-Video

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 de "16:9", "9:16", "1:1".

Formato de Solicitação: Image-To-Video

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 acessível publicamente 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 de aspecto da imagem de origem para melhores resultados.

Formato de Resposta

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

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

Poll o status endpoint até o trabalho estar completo:

GET /api/v1/jobs/sdf_2026_abc123xyz

Uma resposta completa:

{
  "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 o video_url e você tem 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"
    }
    
    # Submit generation job
    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 queued: {job_id}, estimated {job['estimated_seconds']}s")
    
    # Poll for completion
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Complete: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generation failed: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

# Usage
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'
  };

  // Submit generation job
  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 queued: ${job.job_id}`);

  // Poll for completion
  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(`Generation failed: ${status.error}`);
    }
  }
}

// Usage
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 construir na API? Obtenha sua chave de API →

Preço Por Chamada de API

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

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

Limites de Taxa e Throughput

A Seedance 2.0 Fast API permite envios de trabalho concorrentes dentro de limites razoáveis. Contas típicas podem enviar 5-10 trabalhos em paralelo sem atingir throttles. Contas do tier Enterprise podem solicitar concorrência maior.

Trabalhos de geração individuais levam 30-150 segundos dependendo da duração. Com 5 trabalhos concorrentes, você pode efetivamente produzir um clipe a cada ~15-30 segundos de tempo de parede.

Para geração em batch em massa (50+ clipes), envie em ondas de 5-10, aguarde conclusão, depois envie a próxima onda. Não inunde a API com centenas de solicitações simultâneas.

Tratamento de Erros

Respostas de erro comuns:

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

401 Unauthorized: Chave API ausente ou inválida.

402 Payment Required: Créditos insuficientes. Recarregue via dashboard.

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

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

Construa sua integração para lidar com 429 e 500 graciosamente com lógica de retry. Um backoff exponencial simples (1s, 2s, 4s, 8s) cobre a maioria das falhas transitórias.

Fast vs Standard em Contexto de API

A escolha entre endpoints Fast e standard é principalmente econômica:

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

A maioria dos apps usa Fast por padrão. O endpoint standard é tipicamente reservado para recursos de "tier premium" ou solicitações específicas do usuário.

URLs dos endpoints:

• Fast text: bytedance/seedance-2.0/fast/text-to-video
• Fast image: bytedance/seedance-2.0/fast/image-to-video
• Standard text: bytedance/seedance-2.0/text-to-video
• Standard image: bytedance/seedance-2.0/image-to-video

Suporte a Webhook

Para trabalhos de longa duração, polling é desperdiçador. A Seedance 2.0 Fast API suporta callbacks de webhook - inclua uma webhook_url no corpo da sua solicitação e você receberá um POST quando o trabalho 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 - webhooks podem retentar em caso de falha.

Perguntas Comuns, Respostas Rápidas

Qual é o máximo de trabalhos concorrentes que posso enviar? Contas típicas: 5-10. Enterprise: negociável.

Os créditos são deduzidos em trabalhos falhados? Não. Trabalhos falhados reembolsam os créditos automaticamente.

Posso cancelar um trabalho em progresso? Sim, via POST /api/v1/jobs/{job_id}/cancel. Reembolsa créditos se cancelado antes da conclusão.

Qual é o formato de 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? URLs CDN de saída são válidas por 7 dias. Baixe e armazene-as em seu próprio sistema para uso de longo prazo.

Existe um modo de sandbox/teste? Sem sandbox dedicado. Use seus 50 créditos de inscrição grátis para testar. O tier Starter de $10 também é uma forma de baixo risco de construir contra endpoints reais.

Comece a Construir Na Seedance 2.0 Fast API

A API é deliberadamente simples: dois endpoints, preços determinísticos, modelo de trabalho assíncrono, e um teto de qualidade que corresponde ao tier flagship Seedance 2.0. Construa sobre ela para ferramentas sociais, automação de marketing, plataformas de criadores, mecanismos de conteúdo de e-commerce, ou apps criativos internos. A economia unitária finalmente torna a geração de vídeo viável como um recurso dentro de outros produtos.

Pronto para construir? Obtenha sua chave de API →

Continue lendo: guia completo de Seedance 2.0 Fast • preços de Seedance 2.0 Fast • criação em lote de Seedance 2.0 Fast