Série Seedance

Os modelos de geração de vídeo da ByteDance, quatro no total, chamados pelo endpoint de vídeo da OfoxAI POST /v1/videos. As tarefas são executadas de forma assíncrona: ao criar a tarefa, você recebe um ID e consulta o resultado com ele.

Escolha do modelo

Os quatro suportam texto para vídeo, imagem para vídeo e referência de vídeo, e podem gerar uma faixa de áudio sincronizada (generate_audio tem padrão true). adaptive mantém a proporção da imagem de entrada.

A tabela acima corresponde ao video_attributes retornado pela Models API; se as capacidades de um modelo mudarem, prevalece o retorno da API. A cobrança é por segundo, e o custo real é o usage.video_cost no resultado da tarefa. Os preços estão na página do modelo .

Exemplos de chamada

Os exemplos abaixo mostram apenas a requisição de criação da tarefa. O fluxo completo de consulta de status e download do resultado está em Video API · Início rápido.

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0-mini",
    "prompt": "Uma raposa correndo na neve, com a câmera acompanhando",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "O cachorro da imagem corre em direção à câmera",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/dog.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "Um botão de flor se abre lentamente em uma rosa desabrochada",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/bud.jpg" }, "frame_type": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/rose.jpg" }, "frame_type": "last_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.5",
    "prompt": "A garota da imagem 1 segura a xícara da imagem 2 e sorri junto à janela de um café",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/girl.jpg" } },
      { "type": "image_url", "image_url": { "url": "https://example.com/cup.jpg" } }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "O personagem fala no tom desta narração, com estilo de câmera inspirado neste vídeo",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/character.jpg" } },
      { "type": "audio_url", "audio_url": { "url": "https://example.com/voice.mp3" } },
      { "type": "video_url", "video_url": { "url": "https://example.com/style-ref.mp4" } }
    ]
  }'

• frame_images e input_references não podem ser enviados juntos; enviar ambos retorna 400 references_conflict.
• As imagens podem ser URLs públicas ou strings que começam com data:image/...;base64,.
• Se não precisar de faixa de áudio, envie "generate_audio": false.
• A descrição completa da estrutura dos campos está em Criar tarefa de vídeo.

Imagens de referência de pessoas reais

A API oficial do Seedance da ByteDance não permite enviar diretamente imagens ou vídeos de referência com rostos de pessoas reais. A documentação oficial do Seedance 2.0 da BytePlus  exige ativos de retrato de pessoas reais autorizados, e o guia da biblioteca de retratos de pessoas reais do Volcano Engine Ark  lista etapas como enviar o convite, concluir a verificação e autorização pela própria pessoa, enviar o ativo, receber a autorização e obter o ID do ativo.

{
  "model": "bytedance/seedance-2.0",
  "prompt": "A pessoa da imagem caminha por um mercado noturno cinematográfico",
  "duration": 5,
  "resolution": "720p",
  "real_person": true,
  "input_references": [
    { "type": "image_url", "image_url": { "url": "https://example.com/person.jpg" } }
  ]
}

• A OfoxAI aplica um pré-processamento de privacidade à imagem de referência antes do envio. Isso pode reduzir rejeições indevidas da moderação anti-deepfake do upstream, mas não garante que o upstream aceite; tarefas rejeitadas pelo upstream não são cobradas.
• real_person é uma instrução de processamento, não uma prova de autorização. Envie apenas imagens que você tenha o direito legal e a autorização para usar.
• Ajustes quando a imagem continua sendo rejeitada e códigos de erro de pré-processamento: veja Imagens de referência de pessoas reais.

Fixar um provedor

Para fixar um provedor, adicione no nível superior da requisição:

"provider": { "type": "byteplus" }

Um valor inválido em provider.type retorna 400 invalid_provider_type; um provedor que não atende o modelo retorna 400 provider_type_unavailable. A descrição geral está em Roteamento de provedores de vídeo.

Erros comuns

Se a tarefa for criada mas falhar na geração, a consulta retorna status: "failed", com o motivo no campo error; timeout corresponde a error.code: "expired". Os códigos de erro completos estão em Códigos de erro da Video API.

Documentação oficial

• API de geração de vídeo Seedance 2.0 da BytePlus 
• Central de documentação do Volcano Engine Ark 
• OfoxAI · Criar tarefa de vídeo

Perguntas frequentes