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

# Usa Seedance 1.0 Pro 250528 con Comfy Router

> Llama a byteplus/seedance-1-0-pro-250528 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router.

Referencia de API para `byteplus/seedance-1-0-pro-250528`, que Comfy Router sirve desde BytePlus.

**Entrada:** Texto, Imagen · **Salida:** Video

## Inicio rápido

Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo.

**ID del modelo:** `byteplus/seedance-1-0-pro-250528`

**Endpoint:** `POST https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528`

**Esperar el resultado**

```python Python theme={null}
from comfy_sdk import Comfy

# Reads COMFY_API_KEY from the environment.
# The SDK automatically creates an idempotency key and reuses it for automatic retries.
with Comfy() as client:
    result = client.models.run(
        "byteplus/seedance-1-0-pro-250528",
        {
            "content": [
                {
                    "text": "A red fox trotting through a snowy pine forest",
                    "type": "text",
                },
            ],
            "duration": 5,
            "ratio": "16:9",
            "resolution": "720p",
        },
    )

print(result)
```

```typescript TypeScript theme={null}
import { comfy } from "@comfyorg/sdk";

// Reads COMFY_API_KEY from the environment.
// The SDK automatically creates an idempotency key and reuses it for automatic retries.
const { data } = await comfy.models.run("byteplus/seedance-1-0-pro-250528", {
  content: [
    {
      text: "A red fox trotting through a snowy pine forest",
      type: "text",
    },
  ],
  duration: 5,
  ratio: "16:9",
  resolution: "720p",
});

console.log(data);
```

```bash cURL theme={null}
curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528 \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"content\": [{\"text\":\"A red fox trotting through a snowy pine forest\",\"type\":\"text\"}], \"duration\": 5, \"ratio\": \"16:9\", \"resolution\": \"720p\"}"
```

**Encolar y recoger más tarde**

El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](https://docs.comfy.org/es/development/comfy-router/queue.md) explica el estado, la cancelación y la recogida.

```python Python theme={null}
import asyncio
from comfy_sdk import AsyncComfy

# Reads COMFY_API_KEY from the environment.
# Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
async def main():
    async with AsyncComfy() as client:
        handle = await client.models.submit(
            "byteplus/seedance-1-0-pro-250528",
            {
                "content": [
                    {
                        "text": "A red fox trotting through a snowy pine forest",
                        "type": "text",
                    },
                ],
                "duration": 5,
                "ratio": "16:9",
                "resolution": "720p",
            },
        )
        print("request_id:", handle.request_id)  # with the model ID, all another process needs

        # Poll until the request completes, waiting the Retry-After the server names.
        async for update in handle.iter_events():
            print(update.status, update.queue_position)

        # The provider's own payload, the same value models.run() returns.
        # A request that failed or was cancelled raises the typed Router error here.
        result = await handle.get()

    print(result)

asyncio.run(main())
```

```typescript TypeScript theme={null}
import { comfy } from "@comfyorg/sdk";

// Reads COMFY_API_KEY from the environment.
// Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
const handle = await comfy.models.submit("byteplus/seedance-1-0-pro-250528", {
  content: [
    {
      text: "A red fox trotting through a snowy pine forest",
      type: "text",
    },
  ],
  duration: 5,
  ratio: "16:9",
  resolution: "720p",
});
console.log("requestId:", handle.requestId); // with the model ID, all another process needs

// Poll until the request completes, waiting the Retry-After the server names.
for await (const update of handle.events()) {
  console.log(update.status, update.queuePosition);
}

// The same result models.run() returns. A request that failed or was cancelled rejects here.
const result = await handle.get();

console.log(result.data);
```

```bash cURL theme={null}
# 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url.
curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"content\": [{\"text\":\"A red fox trotting through a snowy pine forest\",\"type\":\"text\"}], \"duration\": 5, \"ratio\": \"16:9\", \"resolution\": \"720p\"}"

# 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names.
REQUEST_ID="<request_id from the 201 body>"
curl -i https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$REQUEST_ID/status \
  -H "X-API-Key: $COMFY_API_KEY"

# 3. Collect. 200 with the model's native output, 202 with the status body while it is still running.
curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$REQUEST_ID \
  -H "X-API-Key: $COMFY_API_KEY"
```

## Esquema

### Entrada

**callback\_url** `string (uri)`

Dirección de notificación de callback para el resultado de esta tarea de generación

Formato: `uri`

**content** `object[]` *required*

El contenido de entrada para que el modelo genere un video

**content\[].audio\_url** `object`

Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar solo audio: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio.

**content\[].audio\_url.url** `string` *required*

URL de audio, codificación Base64 o ID de recurso.
URL de audio: URL pública del audio (wav, mp3).
Base64: formato data:audio/\<format>;base64,\<content>
ID de recurso: formato asset://\<ASSET\_ID>

**content\[].draft\_task** `object`

Solo Seedance 2.5. La tarea Draft que se va a renderizar como video final. Debe ser el único elemento de contenido.
El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate\_audio y omni\_reference\_task\_type de la tarea Draft; no los envíes de nuevo. resolution tiene 1080p como valor predeterminado y solo admite 1080p.

**content\[].draft\_task.id** `string` *required*

El ID de tarea que se devolvió cuando se creó el video Draft con `draft` establecido en true.

**content\[].image\_url** `object`

**content\[].image\_url.url** `string` *required*

Contenido de imagen para la generación de imagen a video (cuando type es "image\_url")
URL de la imagen: asegúrate de que la URL de la imagen sea accesible.
Contenido codificado en Base64: el formato debe ser data:image/\<format>;base64,\<content>
ID de recurso: formato asset://\<ASSET\_ID>

**content\[].role** `string`

El rol o la posición del elemento de contenido.
Para imágenes: first\_frame, last\_frame o reference\_image.
Para videos: reference\_video (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini).
Para audio: reference\_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini).

Valores posibles: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio`

**content\[].text** `string`

La información de texto de entrada para el modelo. Incluye el prompt de texto y parámetros opcionales.

Prompt de texto (requerido): descripción del video que se va a generar con caracteres chinos e ingleses.

Parámetros (opcionales): agrega --\[parameters] después del prompt de texto para controlar las especificaciones del video:

* \--resolution (--rs): 480p, 720p, 1080p (predeterminado: 720p)
* \--ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (predeterminado: 16:9 o adaptive)
* \--duration (--dur): 3-12 segundos (predeterminado: 5)
* \--framepersecond (--fps): 24 (predeterminado: 24)
* \--watermark (--wm): true/false (predeterminado: false)
* \--seed (--seed): -1 a 2^32-1 (predeterminado: -1)
* \--camerafixed (--cf): true/false (predeterminado: false)

Ejemplo: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5"

Límite de protección del lado de Comfy, no una restricción de BytePlus. BytePlus no
publica un límite de longitud de texto y aceptó 40,000 caracteres en pruebas (2026-09-17).
Cuenta caracteres, no bytes, así que un prompt multibyte puede ocupar en la red varias
veces este tamaño. Limita este único campo, no la solicitud:
`content` es un arreglo, y el límite del cuerpo por solicitud es lo que limita el
documento completo. Comfy Router (/v2/models/byteplus/\{model}) es la superficie
que lo aplica; en una llamada directa a v1 /proxy responde el validador propio de
BytePlus. Está establecido muy por encima del tráfico real para que nunca determine el
resultado de un prompt genuino; auméntalo si un cliente necesita más.

**content\[].type** `string` *required*

El tipo del contenido de entrada

Valores posibles: `text`, `image_url`, `video_url`, `audio_url`, `draft_task`

**content\[].video\_url** `object`

Objeto de video de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de video.

**content\[].video\_url.url** `string` *required*

URL de video o ID de recurso.
URL de video: URL pública del video (mp4, mov).
ID de recurso: formato asset://\<ASSET\_ID>

**draft** `boolean` (default: false)

Solo Seedance 2.5. Genera un video Draft de 480p; la resolution debe ser 480p.
Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final de 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días.

**duration** \`\`-1` | object`

Duración del video en segundos. Seedance 2.5: \[4,30] o -1 (automático; las tareas de edición de video solo admiten -1). Seedance 2.0, 2.0 fast y 2.0 mini: \[4,15] o -1 (automático). Seedance 1.5 pro: \[4,12] o -1. Seedance 1.0: \[2,12].

Rango: `2` a `30`

**execution\_expires\_after** `integer`

Umbral de tiempo de espera de la tarea en segundos. Valor predeterminado 172800 (48 h). Alcance: \[3600, 259200].

Rango: `3600` a `259200`

**generate\_audio** `boolean` (default: true)

Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes.
true: el modelo genera un video con audio sincronizado.
false: el modelo genera un video sin audio.
En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en ese caso vuelve a crear el Draft con `false`.

**model** `string`

El ID del modelo que se va a llamar. Modelos compatibles: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo: el proxy rechaza con un 400 cualquier otro valor y también la omisión. NO está en la lista `required` de este esquema porque Comfy Router lo completa desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama desde Router lo omite.

**output\_format** `string` (default: "mp4")

Solo Seedance 2.5. Formato de contenedor del video de salida.
mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo.
mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para posproducción; mayor tamaño de archivo.

Valores posibles: `mp4`, `mov`

**ratio** `string`

Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro, predeterminado: adaptive.
Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos.

Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive`

**resolution** `string`

Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite, predeterminado: 720p. Seedance 1.0 pro y pro-fast, predeterminado: 1080p.
Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p y 1080p.

Valores posibles: `480p`, `720p`, `1080p`, `4k`

**return\_last\_frame** `boolean` (default: false)

Indica si se debe devolver la imagen del último fotograma del video generado.
true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto de píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos.
false: No devuelve la imagen del último fotograma del video generado.

**seed** `integer`

Entero de semilla para controlar la aleatoriedad. Alcance: \[-1, 2^32-1]. -1 usa una semilla aleatoria.

Rango: `-1` a `4294967295`

**service\_tier** `string`

Nivel de servicio para el procesamiento. Seedance 2.5, 2.0 y 2.0 fast no admiten flex (inferencia sin conexión).

Valores posibles: `default`, `flex`

**watermark** `boolean` (default: false)

Indica si el video generado incluye una marca de agua.

Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.

### Salida

**content** `object`

La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus devuelve una, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se VUELVEN A ALOJAR en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Admite nulo: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o nulo.

**content.last\_frame\_url** `string`

URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de la imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG del lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo según el Content-Type del origen o una detección de contenido, y `image/jpeg` es solo el último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas, firmada por 24 horas al emitirse y reproducida desde una memo de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL.

**content.output\_format** `string`

Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo como un hermano de NIVEL SUPERIOR de `content`; consulta el campo `output_format` de nivel superior, y Router lee el que de los dos esté presente.

**content.video\_url** `string`

URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas, firmada por 24 horas al emitirse y reproducida desde una memo de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL.

**created\_at** `integer`

La hora en que se creó la tarea. El valor es una marca de tiempo UNIX en segundos.

**duration** `number`

La duración del video generado en segundos. Se declara como un número en lugar de un entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe suponer un valor entero. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios.

**error** `object`

La información del error. Si la tarea tiene éxito, devuelve null. Si la tarea falla, devuelve la información del error.

**error.code** `string`

Código de error de ModelArk del origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en envoltorios de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas, sin sobrescribir los fallos de transporte.

**error.message** `string`

El mensaje de error

**id** `string`

El ID de la tarea de generación de video

**model** `string`

El nombre y la versión del modelo usado por la tarea

**output\_format** `string`

Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`; aquí es donde lo devuelve la consulta de tareas de video de Seedance. Campo propio de BytePlus, reenviado sin cambios.

**resolution** `string`

La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios.

**seed** `integer`

La semilla de generación que se usó realmente para la tarea. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios.

Formato: `int64`

**status** `string`

El estado de la tarea

Valores posibles: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired`

**updated\_at** `integer`

La hora en que se actualizó la tarea por última vez. El valor es una marca de tiempo UNIX en segundos.

**usage** `object`

El uso de tokens de la solicitud

**usage.completion\_tokens** `integer`

La cantidad de tokens generados por el modelo

**usage.total\_tokens** `integer`

Para el modelo de generación de video, la cantidad de tokens de entrada no se calcula y su valor predeterminado es 0. Por lo tanto, total\_tokens = completion\_tokens.

## Ejemplos

### Entrada

```json theme={null}
{
  "content": [
    {
      "text": "A red fox trotting through a snowy pine forest",
      "type": "text"
    }
  ],
  "duration": 5,
  "ratio": "16:9",
  "resolution": "720p"
}
```

### Salida

```json theme={null}
{
  "content": {
    "last_frame_url": "https://example.invalid/byteplus/seedance-1-0-pro-250528/last-frame",
    "video_url": "https://example.invalid/byteplus/seedance-1-0-pro-250528/generated.mp4"
  },
  "created_at": 1767225600,
  "duration": 5,
  "error": null,
  "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60",
  "model": "seedance-1-0-pro-250528",
  "output_format": "mp4",
  "resolution": "1080p",
  "seed": 1234567890123,
  "status": "succeeded",
  "updated_at": 1767225730
}
```

## Antes de lanzar

Los SDK crean una `Idempotency-Key` y la reutilizan para los reintentos automáticos. Para los reintentos manuales, reutiliza la clave original. Router puede mantener la conexión abierta hasta 10 minutos.

Cuando una solicitud falla, Router envía un encabezado de respuesta `X-Comfy-Error-Type` que explica el motivo. Un `422` significa que Router rechazó la entrada antes de llamar al proveedor, y un `413` significa que el cuerpo de la solicitud era más grande de lo que Router acepta. Descarga los recursos generados de inmediato, porque [las URL de resultados pueden caducar](https://docs.comfy.org/es/development/comfy-router/reference.md#recursos-del-resultado).

Cualquier límite de tamaño mencionado en la descripción de un campo más arriba es el límite propio del proveedor para ese campo, citado de la especificación del proveedor. Router aplica un tope aparte al cuerpo completo de la solicitud, con el que cuentan los medios codificados en base64: consulta [tamaño del cuerpo de la solicitud](https://docs.comfy.org/es/development/comfy-router/limitations.md#los-cuerpos-de-las-solicitudes-tienen-un-límite).

Esta página documenta un modelo socio al que se llama a través de Comfy Router. El mismo paquete `comfy-sdk` / `@comfyorg/sdk` también incluye un segundo cliente, para ejecutar todo un gráfico de flujo de trabajo de ComfyUI en Comfy Cloud: `Comfy(api_key=...)` / `new Comfy({ apiKey })`, con `client.workflows`, `client.assets` y `client.jobs`. Consulta [SDK de Comfy](https://docs.comfy.org/es/development/api-development/sdks.md).

> **[Encabezados](https://docs.comfy.org/es/development/comfy-router/headers.md)**
>
> Autenticación, idempotencia, IDs de solicitud, agrupaciones de errores, ritmo de reintentos y límites de gasto.

> **[Uso de la API de Router](https://docs.comfy.org/es/development/comfy-router/api.md)**
>
> Descubrimiento de modelos, errores de validación, reintentos y facturación.

> **[Limitaciones](https://docs.comfy.org/es/development/comfy-router/limitations.md)**
>
> Lo que Router no hace hoy y qué usar en su lugar.


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