Generación de vídeo Seedance 2.0 | Documentación de API

# Seedance 2.0 Video Generation

Seedance 2.0 text, first/last-frame, multimodal, and audio generation parameters.

POST https://api.apihop.ai/v1/video/seedance

Create an asynchronous Seedance 2.0 job. For Seedance 2.5, use its [separate parameter reference](https://apihop.ai/en/docs/api-reference/BytePlus/seedance-2-5).

## Authentication

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Body

### `model` (string, required)

`seedance-2.0` or its alias `seedance-2-0`.

### `prompt` (string)

Video prompt. Required for text-only generation; may be omitted or blank when image or video references are supplied. Audio alone is not a valid input. Text items inside `metadata.content` are discarded; only this top-level prompt is used.

### `seconds` (string, Default: 5)

Integer string from `"4"` through `"15"`. The numeric `duration` alias is also accepted. If both are supplied, they must agree. Automatic duration (`-1`) is not supported.

### `size` (string, Default: 720p)

Output resolution: `480p`, `720p`, `1080p`, or `4k`. Not an aspect ratio. Resolution precedence: `metadata.resolution`, `size`, then `resolution`.

### `aspectRatio` (string, Default: 16:9)

`16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, or `adaptive`. `aspect_ratio` and `ratio` are aliases; `metadata.ratio` takes precedence. Use one alias for each setting.

### `metadata` (object)

Accepts `resolution`, `ratio`, `content`, and `generate_audio`. Set `generate_audio` to a boolean to control generated audio. Top-level `generateAudio` / `generate_audio` are aliases; supply only one audio control.

### `images` (string[])

Image shorthand: the first image is the first frame and the second is the last frame. For precise roles, use `metadata.content`. Existing `imageUrls`, `imageUrl`, `image_urls`, and `image_url` aliases remain accepted with the same frame semantics.

### `imageWithRoles` (object[])

Images with `url` and `role`: `first_frame`, `last_frame`, or `reference_image`. `image_with_roles` is an alias. Both versions also accept typed `metadata.content`.

### `videoUrls` (string[])

Reference videos. `videoUrl`, `video_urls`, and `video_url` are aliases.

### `audioUrls` (string[])

Reference audio. `audioUrl`, `audio_urls`, and `audio_url` are aliases. Requires an image or video reference in the same request.

### `callback_url` (string)

Optional native callback URL. Availability depends on the selected channel; use `GET https://api.apihop.ai/v1/jobs/{jobId}` as the authoritative result.

## Multimodal Content

Each `metadata.content` media item contains its matching nested URL object. Media URLs may use public HTTP(S) URLs or existing `asset://` identifiers.

| Type | URL field | Roles |
| --- | --- | --- |
| `image_url` | `image_url.url` | `first_frame`, `last_frame`, `reference_image` |
| `video_url` | `video_url.url` | `reference_video` |
| `audio_url` | `audio_url.url` | `reference_audio` |

Up to 9 images, 3 videos, and 3 audio files are accepted, including shorthand and typed content. Audio requires an image or video. `draft_task` is not supported. Use top-level `prompt` instead of `type: "text"` content items. Top-level `first_frame_url`, `last_frame_url`, `reference_image_urls`, `reference_video_urls`, and `reference_audio_urls` are role-specific shorthand. Unlisted fields inside content items are not forwarded.

Unsupported controls such as `negativePrompt`, `seed`, `returnLastFrame`, `nsfwCheck`, `tools`, `webhook`, `watermark`, `outputFormat`, and their snake-case aliases are rejected. `width`, `height`, `fps`, `cfgScale`, `steps`, and `style` are not supported.

## Request Examples

### Text-to-Video

```json
{
  "model": "seedance-2.0",
  "prompt": "A quiet city street at dawn, slow forward camera movement",
  "seconds": "5",
  "size": "720p",
  "metadata": {"ratio": "16:9", "generate_audio": true}
}
```

### First and Last Frames

```json
{
  "model": "seedance-2.0",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "9:16",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
      {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"}
    ]
  }
}
```

### Image and Audio References

```json
{
  "model": "seedance-2.0",
  "prompt": "Animate the scene to match the rhythm",
  "metadata": {
    "resolution": "720p",
    "generate_audio": true,
    "content": [
      {"type": "image_url", "image_url": {"url": "asset://existing-image-id"}, "role": "reference_image"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/beat.mp3"}, "role": "reference_audio"}
    ]
  }
}
```

## Submission and Result

Response `data` contains `jobId`, `status`, `model`, and `message`. Submission success means the job was accepted, not completed. Poll `GET https://api.apihop.ai/v1/jobs/{jobId}` with the same account's API Key. See [Get Async Job](https://apihop.ai/en/docs/api-reference/jobs).

When status is `COMPLETED`, read `data.outputResult`. Accept both a string `url` and an array of URLs in each result object. Charges depend on actual completion tokens and output resolution; video references select the video-input rate, while image/audio-only references do not.

Crea una tarea asíncrona de Seedance 2.0. Para Seedance 2.5, usa su referencia de parámetros independiente.

Autenticación

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Cuerpo

modelstringobligatorio

seedance-2.0 o su alias seedance-2-0.

promptstring

Instrucción de vídeo. Obligatoria para generación solo con texto; puede omitirse o estar vacía si hay referencias de imagen o vídeo. El audio por sí solo no es una entrada válida. Los elementos de texto de metadata.content se descartan; solo se usa esta instrucción de nivel superior.

secondsstringPredeterminado: 5

Cadena que representa un entero de "4" a "15". También se acepta el alias numérico duration. Si se proporcionan ambos, deben coincidir. La duración automática (-1) no se admite.

sizestringPredeterminado: 720p

Resolución de salida: 480p, 720p, 1080p o 4k. No es una relación de aspecto. Prioridad de resolución: metadata.resolution, size y después resolution.

aspectRatiostringPredeterminado: 16:9

16:9, 9:16, 1:1, 4:3, 3:4, 21:9 o adaptive. aspect_ratio y ratio son alias; metadata.ratio tiene prioridad. Usa un solo alias para cada ajuste.

metadataobject

Acepta resolution, ratio, content y generate_audio. Establece generate_audio en un booleano para controlar el audio generado. generateAudio / generate_audio de nivel superior son alias; proporciona un único control de audio.

imagesstring[]

Forma abreviada para imágenes: la primera imagen es el fotograma inicial y la segunda el final. Para roles precisos, usa metadata.content. Los alias existentes imageUrls, imageUrl, image_urls e image_url siguen aceptándose con la misma semántica de fotogramas.

imageWithRolesobject[]

Imágenes con url y role: first_frame, last_frame o reference_image. image_with_roles es un alias. Ambas versiones también aceptan metadata.content tipado.

videoUrlsstring[]

Vídeos de referencia. videoUrl, video_urls y video_url son alias.

audioUrlsstring[]

Audio de referencia. audioUrl, audio_urls y audio_url son alias. Requiere una referencia de imagen o vídeo en la misma solicitud.

callback_urlstring

URL opcional de callback nativo. Su disponibilidad depende del canal elegido; usa GET https://api.apihop.ai/v1/jobs/{jobId} como resultado de referencia.

Contenido multimodal

Cada elemento multimedia de metadata.content contiene el objeto URL anidado correspondiente. Las URL pueden ser direcciones HTTP(S) públicas o identificadores asset:// existentes.

Tipo	Campo URL	Roles
`image_url`	`image_url.url`	`first_frame`, `last_frame`, `reference_image`
`video_url`	`video_url.url`	`reference_video`
`audio_url`	`audio_url.url`	`reference_audio`

Se aceptan hasta 9 imágenes, 3 vídeos y 3 archivos de audio, contando formatos abreviados y contenido tipado. El audio requiere una imagen o vídeo. draft_task no se admite. Usa prompt de nivel superior en lugar de elementos type: "text". Los campos de nivel superior first_frame_url, last_frame_url, reference_image_urls, reference_video_urls y reference_audio_urls son formas abreviadas por rol. Los campos no listados dentro de los elementos de contenido no se reenvían.

Se rechazan controles no compatibles como negativePrompt, seed, returnLastFrame, nsfwCheck, tools, webhook, watermark, outputFormat y sus alias snake_case. width, height, fps, cfgScale, steps y style no se admiten.

Ejemplos de solicitudes

Texto a vídeo

json

{
  "model": "seedance-2.0",
  "prompt": "A quiet city street at dawn, slow forward camera movement",
  "seconds": "5",
  "size": "720p",
  "metadata": {"ratio": "16:9", "generate_audio": true}
}

Fotogramas inicial y final

json

{
  "model": "seedance-2.0",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "9:16",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
      {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"}
    ]
  }
}

Referencias de imagen y audio

json

{
  "model": "seedance-2.0",
  "prompt": "Animate the scene to match the rhythm",
  "metadata": {
    "resolution": "720p",
    "generate_audio": true,
    "content": [
      {"type": "image_url", "image_url": {"url": "asset://existing-image-id"}, "role": "reference_image"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/beat.mp3"}, "role": "reference_audio"}
    ]
  }
}

Envío y resultado

El campo data de la respuesta contiene jobId, status, model y message. Un envío correcto significa que la tarea se ha aceptado, no que haya terminado. Consulta periódicamente GET https://api.apihop.ai/v1/jobs/{jobId} con una clave de la misma cuenta. Consulta Consultar tarea asíncrona.

Cuando el estado sea COMPLETED, lee data.outputResult. Acepta tanto un url de tipo cadena como una matriz de URL en cada objeto de resultado. Los cargos dependen de los tokens reales de finalización y de la resolución de salida; las referencias de vídeo seleccionan la tarifa de entrada de vídeo, mientras que las referencias solo de imagen/audio no.