> ## 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.

# API ByteDance Seedance na Krea

> Utilize o ByteDance Seedance 2.5 e 2.0 através da Krea API. Gere vídeo a partir de texto ou imagens com exemplos REST e JavaScript, chaves de API e ligações para preços.

A Krea disponibiliza acesso por API aos modelos de geração de vídeo Seedance da ByteDance. Utilize a API Seedance na Krea para gerar vídeos a partir de texto, animar imagens ou orientar a geração com referências de imagem, vídeo e áudio. Os pedidos usam um token de API da Krea e o URL base `https://api.krea.ai`.

## Modelos da API Seedance disponíveis

| 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 |

Estes modelos suportam texto para vídeo, frames inicial e final, multimédia de referência e áudio nativo. Consulte a [referência da API](https://www.krea.ai/docs/api-reference/introduction.md) para ver o esquema de pedido atual de cada modelo. Verifique os [preços da API ↗](https://www.krea.ai/app/api/pricing) antes de submeter uma tarefa; o preço depende do modelo e das definições de geração.

> [!NOTE]
>
> Os endpoints Seedance 2.0 e 2.0 Fast da Krea incluem melhoria de prompt e upscaling opcionais da Krea, para além do modelo base. O Seedance 2.5 inclui melhoria de prompt opcional da Krea. Nos pedidos de edição de vídeo do Seedance 2.5 com `reference_videos`, a duração e a proporção da saída são determinadas pelo vídeo de origem; `duration` e `aspect_ratio` são ignorados nesses pedidos.

## Obter uma chave da API Seedance

Crie um token de API da Krea e carregue saldo de API através de [Chaves de API e faturação](https://www.krea.ai/docs/pt/developers/api-keys-and-billing.md). Guarde o token na variável de ambiente `KREA_API_KEY` no seu servidor. Envie-o como `Authorization: Bearer $KREA_API_KEY` e nunca o exponha em código do navegador.

A computação da aplicação Krea e o saldo de API são independentes. Os pedidos Seedance feitos através da Krea API usam o saldo de API da sua workspace.

## Gerar um vídeo

Submeta um prompt ao endpoint do Seedance 2.5 para gerar vídeo a partir de texto. Estes exemplos pedem 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 de JavaScript com `npm install @krea-ai/sdk`. O pedido REST devolve um `job_id`, e não o vídeo final. Consulte `GET /jobs/{job_id}` a cada 2–5 segundos até que `status` seja `completed` e, em seguida, leia o URL do vídeo em `result.urls[0]`. Pare o polling se o estado for `failed` ou `cancelled`. O método `jobs.wait` do SDK trata do polling por si.

```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, utilize [webhooks](https://www.krea.ai/docs/pt/developers/webhooks.md) para receber eventos de conclusão. Consulte [ciclo de vida das tarefas](https://www.krea.ai/docs/pt/developers/job-lifecycle.md) e [erros e depuração](https://www.krea.ai/docs/pt/developers/errors-and-debugging.md) para conhecer os estados das tarefas e o tratamento de falhas.

## Animar uma imagem

Para gerar vídeo a partir de imagem com o Seedance, utilize o mesmo endpoint e adicione `start_image` ao pedido. Indique um URL de imagem acessível publicamente, um URL de um recurso carregado ou um URI de dados 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` pelo URL da sua própria imagem. Para controlar o frame final, adicione `end_image`. Para geração orientada por referências, utilize `reference_images`, `reference_videos` e `reference_audios` de acordo com o [esquema da API](https://www.krea.ai/docs/api-reference/introduction.md) do modelo selecionado.

## Perguntas frequentes

### A Krea oferece uma API ByteDance Seedance?

Sim. A Krea oferece o ByteDance Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast e Seedance 2.0 Mini através da sua API REST em `https://api.krea.ai`. Autentique-se com um token de API da Krea e submeta um pedido a um dos endpoints Seedance indicados acima.

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

Sim. Envie um `prompt` para texto para vídeo ou adicione `start_image` para animar uma imagem. Ambos os fluxos de trabalho usam o mesmo endpoint do modelo Seedance e devolvem uma tarefa assíncrona.

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

Não. As chamadas ao Seedance através da Krea usam o seu token de API da Krea e o saldo de API da sua workspace. Não precisa de enviar uma credencial ByteDance separada com estes pedidos.

### Quanto custa a API Seedance 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 definições disponíveis. A utilização da API é faturada separadamente da computação da aplicação Krea. As tarefas falhadas e canceladas não são faturadas.

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

Sim. Ligue um agente ao [servidor MCP da Krea](https://www.krea.ai/docs/pt/developers/mcp.md) para descobrir os modelos de vídeo disponíveis e os respetivos esquemas. Também pode chamar a API REST ou o SDK de JavaScript diretamente a partir da sua aplicação.


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