Saltar para o conteúdo principal

​
Introdução

Seedance é um serviço de vídeo AI fornecido pela Ace Data Cloud, baseado no modelo de geração de vídeo Seedance da ByteDance. Através da API unificada da Ace Data Cloud, você pode integrar rapidamente o Seedance com Python para criar vídeos a partir de texto, imagens, gerar áudio, e suportar múltiplas resoluções.

​
Pré-requisitos

  • Ter uma conta na Ace Data Cloud e obter o Token da API
  • Ambiente Python 3.7 ou superior
  • Instalar a biblioteca requests: pip install requests

​
Uso Básico

O endpoint principal para chamar a API Seedance é: 
POST https://api.acedata.cloud/seedance/videos
Este exemplo utiliza o modelo doubao-seedance-1-0-pro-250528.
Modelos disponíveis incluem: doubao-seedance-1-5-pro-251215, doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-pro-fast-251015. Exemplo completo de código Python: 
import requests

url = "https://api.acedata.cloud/seedance/videos"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "model": "doubao-seedance-1-0-pro-250528",
    "content": [
        {
            "type": "text",
            "text": "A kitten yawning --rs 720p --rt 16:9 --dur 5"
        }
    ]
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Substitua YOUR_API_TOKEN pelo Token real obtido na plataforma Ace Data Cloud.

​
Tratamento da Resposta

Após uma chamada bem-sucedida, a API retorna dados em formato JSON. Recomenda-se verificar o código de status HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Chamada bem-sucedida:", result)
else:
    print(f"Falha na chamada, código de status: {response.status_code}")
    print(response.text)

​
Uso Avançado

Para APIs que suportam tarefas assíncronas, é possível obter resultados via URL de callback: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# O resultado será enviado para seu servidor através da URL de callback

​
Tratamento de Erros

Códigos de erro comuns:
CódigoDescrição
401Falha de autenticação, verifique o Token da API
403Saldo insuficiente ou acesso negado
429Limite de requisições excedido
500Erro interno do servidor

​
Outros Endpoints

O serviço Seedance também oferece os seguintes endpoints:
  • POST https://api.acedata.cloud/seedance/tasks

​
Próximos Passos