> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ByteDance Seedance API na Krea

> Use o ByteDance Seedance 2.5 e 2.0 pela Krea API. Gere vídeos a partir de texto ou imagens com exemplos em REST e JavaScript, chaves de API e links de preços.

A Krea oferece acesso via API aos modelos de geração de vídeo Seedance da ByteDance. Use a Seedance API na Krea para gerar vídeos a partir de texto, animar imagens ou guiar a geração com referências de imagem, vídeo e áudio. As requisições usam um token da Krea API e a URL base `https://api.krea.ai`.

## Modelos disponíveis da Seedance API

| Modelo | Endpoint POST | Duração do vídeo | Resolução de saída |
| - | - | - | - |
| Seedance 2.5 | `/generate/video/bytedance/seedance-2-5` | 4–30 segundos | 480p, 720p, 1080p |
| Seedance 2.0 | `/generate/video/bytedance/seedance-2` | 4–15 segundos | 480p, 720p, 1080p, 4K |
| Seedance 2.0 Fast | `/generate/video/bytedance/seedance-2-fast` | 4–15 segundos | 480p, 720p |
| Seedance 2.0 Mini | `/generate/video/bytedance/seedance-2-mini` | 4–15 segundos | 480p, 720p |

Esses modelos são compatíveis com texto para vídeo, frames inicial e final, mídias de referência e áudio nativo. Consulte a [referência da API](https://www.krea.ai/docs/api-reference/introduction.md) para ver o schema de requisição atual de cada modelo. Confira os [preços da API ↗](https://www.krea.ai/app/api/pricing) antes de enviar um job; o preço depende do modelo e das configurações de geração.

> [!NOTE]
>
> Os endpoints do Seedance 2.0 e 2.0 Fast na Krea incluem aprimoramento de prompt e upscaling opcionais da Krea, além do modelo base. O Seedance 2.5 inclui aprimoramento de prompt opcional da Krea. Em requisições de edição de vídeo do Seedance 2.5 com `reference_videos`, a duração e a proporção da saída vêm do vídeo de origem; `duration` e `aspect_ratio` são ignorados nessas requisições.

## Obtenha uma chave da Seedance API

Crie um token da Krea API e adicione saldo de API seguindo [Chaves de API e faturamento](https://www.krea.ai/docs/pt-BR/developers/api-keys-and-billing.md). Armazene o token na variável de ambiente `KREA_API_KEY` no seu servidor. Envie-o como `Authorization: Bearer $KREA_API_KEY`; nunca o exponha em código executado no navegador.

As unidades de computação do app da Krea e o saldo de API são separados. Requisições ao Seedance pela Krea API usam o saldo de API do seu workspace.

## Gere um vídeo

Envie um prompt ao endpoint do Seedance 2.5 para geração de texto para vídeo. Estes exemplos solicitam um vídeo horizontal de cinco segundos em 720p.

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body https://api.krea.ai/generate/video/bytedance/seedance-2-5 \
  -H "Authorization: Bearer $KREA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A slow camera orbit around a ceramic vase in warm studio light",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
```

```javascript JavaScript theme={"theme":{"light":"github-light-default","dark":"vesper"}}
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.video("bytedance/seedance-2-5", {
  prompt: "A slow camera orbit around a ceramic vase in warm studio light",
  duration: 5,
  aspect_ratio: "16:9",
  resolution: "720p"
});

const completed = await krea.jobs.wait(job.job_id);
console.log(completed.result.urls[0]);
```

Instale o SDK JavaScript com `npm install @krea-ai/sdk`. A requisição REST retorna um `job_id`, não o vídeo finalizado. Faça polling em `GET /jobs/{job_id}` a cada 2–5 segundos até que `status` seja `completed` e, em seguida, leia a URL do vídeo em `result.urls[0]`. Interrompa o polling em `failed` ou `cancelled`. O método `jobs.wait` do SDK faz o polling para você.

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body "https://api.krea.ai/jobs/YOUR_JOB_ID" \
  -H "Authorization: Bearer $KREA_API_KEY"
```

Em integrações de produção, use [webhooks](https://www.krea.ai/docs/pt-BR/developers/webhooks.md) para receber eventos de conclusão. Consulte [Ciclo de vida do job](https://www.krea.ai/docs/pt-BR/developers/job-lifecycle.md) e [Erros e depuração](https://www.krea.ai/docs/pt-BR/developers/errors-and-debugging.md) para ver os estados dos jobs e o tratamento de falhas.

## Anime uma imagem

Para geração de imagem para vídeo com o Seedance, use o mesmo endpoint e adicione `start_image` à sua requisição. Envie uma URL de imagem acessível publicamente, a URL de um asset enviado ou um data URI em base64.

```json theme={"theme":{"light":"github-light-default","dark":"vesper"}}
{
  "prompt": "The camera slowly moves closer as soft light shifts across the scene",
  "start_image": "https://your-domain.example/product.png",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}
```

Substitua `start_image` pela URL da sua própria imagem. Para controlar o frame final, adicione `end_image`. Para geração guiada por referências, use `reference_images`, `reference_videos` e `reference_audios` de acordo com o [schema da API](https://www.krea.ai/docs/api-reference/introduction.md) do modelo selecionado.

## Perguntas frequentes

### A Krea oferece uma API do ByteDance Seedance?

Sim. A Krea oferece o ByteDance Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast e Seedance 2.0 Mini pela sua API REST em `https://api.krea.ai`. Autentique-se com um token da Krea API e envie uma requisição a um dos endpoints do Seedance listados acima.

### Posso usar o Seedance tanto para texto para vídeo quanto para imagem para vídeo?

Sim. Envie um `prompt` para texto para vídeo ou adicione `start_image` para animar uma imagem. Os dois fluxos usam o mesmo endpoint do modelo Seedance e retornam um job assíncrono.

### Preciso de uma chave de API separada da ByteDance?

Não. Chamadas ao Seedance pela Krea usam seu token da Krea API e o saldo de API do workspace. Você não precisa enviar uma credencial separada da ByteDance nessas requisições.

### Quanto custa a Seedance API na Krea?

Consulte os [preços da Krea API ↗](https://www.krea.ai/app/api/pricing) para ver os preços atuais do Seedance e as configurações disponíveis. O uso da API é cobrado separadamente das unidades de computação do app da Krea. Jobs que falham ou são cancelados não são cobrados.

### Posso chamar o Seedance a partir de um agente de IA?

Sim. Conecte um agente ao [servidor MCP da Krea](https://www.krea.ai/docs/pt-BR/developers/mcp.md) para descobrir os modelos de vídeo disponíveis e seus schemas. Você também pode chamar a API REST ou o SDK JavaScript diretamente da sua aplicação.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.