> ## 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 de ByteDance Seedance en Krea

> Usa ByteDance Seedance 2.5 y 2.0 a través de la API de Krea. Genera video a partir de texto o imágenes con ejemplos de REST y JavaScript, claves de API y enlaces de precios.

Krea ofrece acceso por API a los modelos de generación de video Seedance de ByteDance. Usa la API de Seedance en Krea para generar videos a partir de texto, animar imágenes o guiar la generación con referencias de imagen, video y audio. Las solicitudes usan un token de API de Krea y la URL base `https://api.krea.ai`.

## Modelos de la API de Seedance disponibles

| Modelo | Endpoint POST | Duración del video | Resolución de salida |
| - | - | - | - |
| 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 |

Estos modelos admiten texto a video, fotogramas inicial y final, medios de referencia y audio nativo. Consulta la [referencia de la API](https://www.krea.ai/docs/api-reference/introduction.md) para ver el esquema de solicitud actual de cada modelo. Revisa los [precios de la API ↗](https://www.krea.ai/app/api/pricing) antes de enviar un trabajo; el precio depende del modelo y de la configuración de generación.

> [!NOTE]
>
> Los endpoints de Seedance 2.0 y 2.0 Fast de Krea incluyen mejora de prompts y escalado opcionales de Krea, además del modelo base. Seedance 2.5 incluye mejora de prompts opcional de Krea. En las solicitudes de edición de video de Seedance 2.5 con `reference_videos`, la duración y la relación de aspecto de la salida provienen del video de origen; en esas solicitudes se ignoran `duration` y `aspect_ratio`.

## Obtener una clave de API de Seedance

Crea un token de API de Krea y añade saldo de API desde [Claves de API y facturación](https://www.krea.ai/docs/es/developers/api-keys-and-billing.md). Guarda el token en la variable de entorno `KREA_API_KEY` de tu servidor. Envíalo como `Authorization: Bearer $KREA_API_KEY`; nunca lo expongas en código del navegador.

El cómputo de la app de Krea y el saldo de API son independientes. Las solicitudes de Seedance a través de la API de Krea usan el saldo de API de tu workspace.

## Generar un video

Envía un prompt al endpoint de Seedance 2.5 para generar video a partir de texto. Estos ejemplos solicitan un video horizontal de cinco segundos en 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]);
```

Instala el SDK de JavaScript con `npm install @krea-ai/sdk`. La solicitud REST devuelve un `job_id`, no el video terminado. Consulta `GET /jobs/{job_id}` cada 2–5 segundos hasta que `status` sea `completed` y, después, lee la URL del video en `result.urls[0]`. Deja de consultar si el estado es `failed` o `cancelled`. El método `jobs.wait` del SDK se encarga de las consultas por ti.

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

En integraciones de producción, usa [webhooks](https://www.krea.ai/docs/es/developers/webhooks.md) para recibir los eventos de finalización. Consulta [ciclo de vida de los trabajos](https://www.krea.ai/docs/es/developers/job-lifecycle.md) y [errores y depuración](https://www.krea.ai/docs/es/developers/errors-and-debugging.md) para conocer los estados de los trabajos y cómo gestionar los fallos.

## Animar una imagen

Para generar video a partir de una imagen con Seedance, usa el mismo endpoint y añade `start_image` a tu solicitud. Pasa una URL de imagen de acceso público, la URL de un recurso subido o un data URI en 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"
}
```

Sustituye `start_image` por la URL de tu propia imagen. Para controlar el fotograma final, añade `end_image`. Para la generación guiada por referencias, usa `reference_images`, `reference_videos` y `reference_audios` según el [esquema de la API](https://www.krea.ai/docs/api-reference/introduction.md) del modelo seleccionado.

## Preguntas frecuentes

### ¿Krea ofrece una API de ByteDance Seedance?

Sí. Krea ofrece ByteDance Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast y Seedance 2.0 Mini a través de su API REST en `https://api.krea.ai`. Autentícate con un token de API de Krea y envía una solicitud a uno de los endpoints de Seedance indicados arriba.

### ¿Puedo usar Seedance tanto para texto a video como para imagen a video?

Sí. Envía un `prompt` para texto a video, o añade `start_image` para animar una imagen. Ambos flujos usan el mismo endpoint del modelo Seedance y devuelven un trabajo asíncrono.

### ¿Necesito una clave de API de ByteDance aparte?

No. Las llamadas a Seedance a través de Krea usan tu token de API de Krea y el saldo de API de tu workspace. No necesitas enviar una credencial de ByteDance aparte con estas solicitudes.

### ¿Cuánto cuesta la API de Seedance en Krea?

Consulta los [precios de la API de Krea ↗](https://www.krea.ai/app/api/pricing) para ver los precios actuales de Seedance y la configuración disponible. El uso de la API se factura por separado del cómputo de la app de Krea. Los trabajos fallidos y cancelados no se facturan.

### ¿Puedo llamar a Seedance desde un agente de IA?

Sí. Conecta un agente al [servidor MCP de Krea](https://www.krea.ai/docs/es/developers/mcp.md) para descubrir los modelos de video disponibles y sus esquemas. También puedes llamar a la API REST o al SDK de JavaScript directamente desde tu aplicación.


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