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

# Generación de video seedance-2.0

>  - Modo de procesamiento asíncrono, devuelve un ID de tarea para consultas posteriores
- Admite texto-a-video, imagen-a-video (primer fotograma/último fotograma)
- Admite video de referencia, audio de referencia y video con audio
- Admite proporciones horizontal, vertical, cuadrada, ultra ancha y adaptativa 

```bash cURL theme={null}
curl --request POST \
  --url https://gccai.heqingsong.uk/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.0",
    "prompt": "A kitten yawning at the camera",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'
```

```python Python theme={null}
import requests

url = "https://gccai.heqingsong.uk/v1/videos/generations"

payload = {
    "model": "seedance-2.0",
    "prompt": "A kitten yawning at the camera",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": True
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript JavaScript theme={null}
const url = "https://gccai.heqingsong.uk/v1/videos/generations";

const payload = {
  model: "seedance-2.0",
  prompt: "A kitten yawning at the camera",
  resolution: "720p",
  size: "16:9",
  duration: 5,
  generate_audio: true
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
```

```go Go theme={null}
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://gccai.heqingsong.uk/v1/videos/generations"

    payload := map[string]interface{}{
        "model":          "seedance-2.0",
        "prompt":         "A kitten yawning at the camera",
        "resolution":     "720p",
        "size":           "16:9",
        "duration":       5,
        "generate_audio": true,
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
```

```java Java theme={null}
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://gccai.heqingsong.uk/v1/videos/generations";

        String payload = """
        {
          "model": "seedance-2.0",
          "prompt": "A kitten yawning at the camera",
          "resolution": "720p",
          "size": "16:9",
          "duration": 5,
          "generate_audio": true
        }
        """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer <token>")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}
```

```php PHP theme={null}
<?php

$url = "https://gccai.heqingsong.uk/v1/videos/generations";

$payload = [
    "model" => "seedance-2.0",
    "prompt" => "A kitten yawning at the camera",
    "resolution" => "720p",
    "size" => "16:9",
    "duration" => 5,
    "generate_audio" => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
```

```ruby Ruby theme={null}
require 'net/http'
require 'json'
require 'uri'

url = URI("https://gccai.heqingsong.uk/v1/videos/generations")

payload = {
  model: "seedance-2.0",
  prompt: "A kitten yawning at the camera",
  resolution: "720p",
  size: "16:9",
  duration: 5,
  generate_audio: true
}

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer <token>"
request["Content-Type"] = "application/json"
request.body = payload.to_json

response = http.request(request)
puts response.body
```

```swift Swift theme={null}
import Foundation

let url = URL(string: "https://gccai.heqingsong.uk/v1/videos/generations")!

let payload: [String: Any] = [
    "model": "seedance-2.0",
    "prompt": "A kitten yawning at the camera",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
]

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: payload)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print("Error: \(error)")
        return
    }

    if let data = data, let responseString = String(data: data, encoding: .utf8) {
        print(responseString)
    }
}

task.resume()
```

```csharp C# theme={null}
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var url = "https://gccai.heqingsong.uk/v1/videos/generations";

        var payload = @"{
            ""model"": ""seedance-2.0"",
            ""prompt"": ""A kitten yawning at the camera"",
            ""resolution"": ""720p"",
            ""size"": ""16:9"",
            ""duration"": 5,
            ""generate_audio"": true
        }";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer <token>");

        var content = new StringContent(payload, Encoding.UTF8, "application/json");
        var response = await client.PostAsync(url, content);
        var result = await response.Content.ReadAsStringAsync();

        Console.WriteLine(result);
    }
}
```

```json 200 theme={null}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KMCGF6BQGN3X28H3KSR50X5T"
    }
  ]
}
```

```json 400 theme={null}
{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}
```

```json 401 theme={null}
{
  "error": {
    "code": 401,
    "message": "Authentication failed, please check your API key",
    "type": "authentication_error"
  }
}
```

```json 402 theme={null}
{
  "error": {
    "code": 402,
    "message": "Insufficient account balance, please top up and try again",
    "type": "payment_required"
  }
}
```

```json 429 theme={null}
{
  "error": {
    "code": 429,
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}
```

```json 500 theme={null}
{
  "error": {
    "code": 500,
    "message": "Internal server error, please try again later",
    "type": "server_error"
  }
}
```

## Autenticación

**Authorization** `string` *required*

Todos los endpoints de la API requieren autenticación mediante Bearer Token

Obtenga su API Key:

Visite la [página de gestión de API Keys](https://gccai.heqingsong.uk/keys) para obtener su API Key

Añádala a la cabecera de la solicitud:

```
Authorization: Bearer YOUR_API_KEY
```

## Parámetros de la solicitud

**model** `string` *required*

Nombre del modelo de generación de video

Modelos admitidos:

* `seedance-2.0` - Versión estándar, admite texto-a-video, imagen-a-video, video de primer/último fotograma, video de referencia, audio de referencia y video con audio
* `seedance-2.0-fast` - Versión rápida, mismas funciones que la estándar con mayor velocidad de generación
* `seedance-2.0-mini` - Versión mini, mismas funciones que la versión estándar

**nsfw\_check** `boolean` (default: false)

Indica si se debe moderar el contenido antes de enviar la tarea de vídeo.

* `true`: revisar los prompts y las imágenes de entrada con `omni-moderation-latest`
* `false` u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)

Contenido revisado:

* Texto: `prompt`, `negative_prompt`
* Imágenes: `image_urls`, `image_with_roles[].url`, `first_frame_image`, `last_frame_image`
* Recursos privados de imagen `asset://`: resolver y revisar su URL pública original
* Imágenes Base64: revisarlas después de convertirlas en una URL pública

`video_urls`, `audio_urls` y los recursos privados de vídeo/audio **no se revisan**, ya que el modelo de moderación no admite vídeo ni audio.

ID de modelos compatibles: `seedance-2.0`, `seedance-2.0-fast`, `seedance-2.0-mini`, `seedance-2.0-face`, `seedance-2.0-fast-face`, `seedance-2-0` (nombre antiguo) y `seedance-2.5`.

La llamada de moderación no se factura al usuario que envía la solicitud de vídeo.

> [!WARNING]
>
> * El contenido detectado devuelve HTTP 400 (`nsfw_content_detected`) de forma síncrona. No se crea ninguna tarea ni `task_id`, y no se descuenta cuota de generación de vídeo
> * Si la moderación no está disponible, agota el tiempo de espera o devuelve una respuesta no válida, se aplica **fail-open** y la generación continúa. Esta opción no es una garantía absoluta de seguridad del contenido
> * Las entradas que no puedan resolverse como una URL pública de imagen se omiten; los modelos no compatibles ignoran silenciosamente `nsfw_check: true`

Ejemplo:

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "a cat walking on the beach",
  "image_urls": ["https://cdn.example.com/ref.png"],
  "nsfw_check": true
}
```

Respuesta cuando se detecta contenido:

```json theme={null}
{
  "error": {
    "message": "Your request was rejected by content moderation (`nsfw_check` is enabled). Flagged categories: sexual, violence/graphic.",
    "type": "nsfw_content_detected",
    "param": "",
    "code": "nsfw_content_detected"
  }
}
```

**prompt** `string`

Descripción del contenido del video

Requerido para texto-a-video; opcional para imagen-a-video o video-de-referencia-a-video

Se recomienda especificar claramente el sujeto, la acción, el movimiento de cámara y el estilo para obtener mejores resultados

> [!WARNING]
>
> * El prompt está limitado a 4000 caracteres, pero se recomiendan 500 caracteres.
> * El modelo `seedance-2.0-mini` no tiene límite de caracteres. Recomendación: los prompts en chino no deben superar los 500 caracteres y los prompts en inglés no deben superar las 1000 palabras. Un texto demasiado largo tiende a dispersar la información, y el modelo puede pasar por alto detalles y centrarse solo en los puntos clave, lo que provoca que falten algunos elementos en el vídeo.

Ejemplo: `"A kitten yawning at the camera"`

**duration** `integer` (default: 5)

Duración del video (segundos)

Rango admitido: `4` a `15` segundos

Predeterminado: `5`

**size** `string` (default: 16:9)

Proporción del video

La proporción debe estar entre 0.5 y 2.5

Opciones:

* `16:9` - Horizontal
* `9:16` - Vertical
* `1:1` - Cuadrado
* `4:3` - Proporción tradicional
* `3:4` - Proporción tradicional vertical
* `21:9` - Ultra ancha
* `adaptive` - Adaptativa (coincide automáticamente con la imagen/video de entrada)

Predeterminado: `16:9`

**resolution** `string` (default: 720p)

Resolución del video

Opciones:

* `480p` - Definición estándar
* `720p` - Alta definición
* `1080p` - Full HD (solo admitida por `seedance-2.0`)
* `4k` - Ultra HD (solo admitida por `seedance-2.0`)

Predeterminado: `720p`

**seed** `integer`

Semilla aleatoria para controlar la aleatoriedad del contenido generado

> [!NOTE]
>
> * Con la misma solicitud, valores de seed distintos producirán resultados diferentes
> * Con la misma solicitud, el mismo valor de seed producirá resultados similares, aunque no se garantiza una coincidencia exacta

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

Si se debe generar audio (video con audio)

Cuando se establece en `true`, el video incluirá audio de acompañamiento generado por IA

Cuando se establece en `false`, el video no incluirá audio (video sin sonido)

Predeterminado: `true`

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

Si se debe devolver la imagen del último fotograma

Cuando se establece en `true`, el resultado de la tarea devolverá adicionalmente la URL del último fotograma del video, que puede usarse para generación continua de video

Predeterminado: `false`

**tools** `array\<object\>`

Lista de herramientas para capacidades mejoradas como búsqueda en la web

Ejemplo: `[{"type": "web_search"}]`

**Descripción de los campos**

**type** `string` *required*

Tipo de herramienta

Opciones:

* `web_search` - Búsqueda en la web, hace referencia a información en línea durante la generación

**image\_urls** `array\<string\>`

Array de URLs de imagen para imagen-a-video

Admite dos formatos:

* URL de imagen normal: `https://example.com/cat.jpg`
* Asset URL (asset aprobado): `asset://asset_a`

Ejemplo: `["https://example.com/cat.jpg"]` o `["asset://asset_a"]`

> [!NOTE]
>
> Las Asset URL son compatibles con todos los modelos Seedance 2.0: `seedance-2.0`, `seedance-2.0-fast` y `seedance-2.0-mini`.

> [!WARNING]
>
> * `image_urls` e `image_with_roles` no se pueden usar simultáneamente
> * Máximo de 9 imágenes de referencia

**image\_with\_roles** `array`

Array de imágenes con roles, admite especificar primer fotograma/último fotograma

> [!NOTE]
>
> Cuando el campo `url` usa una Asset URL, se admiten todos los modelos Seedance 2.0: `seedance-2.0`, `seedance-2.0-fast` y `seedance-2.0-mini`.

**Descripción de los campos**

**url** `string` *required*

URL de la imagen

Admite dos formatos:

* URL de imagen normal: `https://example.com/day.jpg`
* Asset URL (asset aprobado): `asset://asset_a`

> [!NOTE]
>
> Las Asset URL son compatibles con todos los modelos Seedance 2.0: `seedance-2.0`, `seedance-2.0-fast` y `seedance-2.0-mini`.

**role** `string` *required*

Rol de la imagen

Opciones:

* `first_frame` - Imagen del primer fotograma, usada como fotograma inicial del video
* `last_frame` - Imagen del último fotograma, usada como fotograma final del video
* `reference_image` - Imagen de retrato de referencia (usada con Asset URL)

Ejemplo:

```json theme={null}
[
  {"url": "https://example.com/day.jpg", "role": "first_frame"},
  {"url": "https://example.com/night.jpg", "role": "last_frame"}
]
```

Formato Asset URL:

```json theme={null}
[
  {"url": "asset://asset_a", "role": "reference_image"}
]
```

> [!WARNING]
>
> * `image_urls` e `image_with_roles` no se pueden usar simultáneamente
> * Al usar imágenes de primer/último fotograma, `video_urls` y `audio_urls` no están disponibles

**video\_urls** `array\<string\>`

Array de URLs de video de referencia

Admite dos formatos:

* URL de video normal: `https://example.com/reference.mp4`
* Asset URL (asset aprobado): `asset://asset_a`

Ejemplo: `["https://example.com/reference.mp4"]` o `["asset://asset_a"]`

> [!NOTE]
>
> Las Asset URL son compatibles con todos los modelos Seedance 2.0: `seedance-2.0`, `seedance-2.0-fast` y `seedance-2.0-mini`.

> [!WARNING]
>
> * Al usar imágenes de primer/último fotograma (`image_with_roles`), los videos de referencia no están disponibles
> * Máximo de 3 videos de referencia, 1.8s \< duración total \< 15.2s
> * La resolución del video de referencia debe estar entre 480P y 720P

**audio\_urls** `array\<string\>`

Array de URLs de audio de referencia

Admite dos formatos:

* URL de audio normal: `https://example.com/speech.wav`
* Asset URL (asset aprobado): `asset://asset_a`

Ejemplo: `["https://example.com/speech.wav"]` o `["asset://asset_a"]`

> [!NOTE]
>
> Las Asset URL son compatibles con todos los modelos Seedance 2.0: `seedance-2.0`, `seedance-2.0-fast` y `seedance-2.0-mini`.

> [!WARNING]
>
> * Al usar imágenes de primer/último fotograma (`image_with_roles`), el audio de referencia no está disponible
> * Máximo de 3 archivos de audio de referencia, duración total de 15s o menos
> * El audio de referencia debe usarse junto con imágenes de referencia o videos de referencia

## Respuesta

**code** `integer`

Código de estado de la respuesta, 200 en caso de éxito

**data** `array`

Array de datos de la respuesta

**Elementos del array**

**status** `string`

Estado de la tarea, `submitted` cuando se envía inicialmente

**task\_id** `string`

Identificador único de la tarea para consultar el estado y los resultados

## Casos de uso

### Caso 1: Texto-a-video

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "A kitten yawning at the camera",
  "resolution": "720p",
  "size": "16:9",
  "duration": 5,
  "seed": 42,
  "generate_audio": true
}
```

### Caso 2: Imagen-a-video (primer fotograma)

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "The kitten stands up and walks toward the camera",
  "image_urls": ["https://example.com/cat.jpg"],
  "duration": 5
}
```

### Caso 3: Video con primer/último fotograma

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "Transition from day to night",
  "image_with_roles": [
    {"url": "https://example.com/day.jpg", "role": "first_frame"},
    {"url": "https://example.com/night.jpg", "role": "last_frame"}
  ],
  "duration": 5
}
```

### Caso 4: Video-de-referencia-a-video

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "Convert the video style to anime style",
  "video_urls": ["https://example.com/reference.mp4"]
}
```

### Caso 5: Video de referencia + audio de referencia

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "A scene of a person speaking",
  "video_urls": ["https://example.com/reference.mp4"],
  "audio_urls": ["https://example.com/speech.wav"],
  "size": "16:9",
  "duration": 11
}
```

### Caso 6: Video con audio

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "A man stops a woman and says: \"Remember, you must never point your finger at the moon.\"",
  "generate_audio": true
}
```

### Caso 7: Generación continua de video (devolver último fotograma)

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "The kitten continues walking toward the camera",
  "image_urls": ["https://example.com/last_frame_from_prev.png"],
  "return_last_frame": true
}
```

### Caso 8: Generación con versión rápida

```json theme={null}
{
  "model": "seedance-2.0-fast",
  "prompt": "City nightscape timelapse photography",
  "size": "21:9",
  "duration": 8
}
```

### Caso 9: Imágenes de referencia + video de referencia + audio de referencia (video multimodal)

Combine imágenes de referencia, video de referencia y audio de referencia para generar un video publicitario inmersivo en primera persona. Ideal para promociones de productos, anuncios de marca y otros escenarios que requieran la fusión de material de múltiples fuentes.

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "Use video 1's first-person perspective throughout, and use audio 1 as the background music throughout. First-person POV fruit tea advertisement for seedance brand 'Peace Apple' apple fruit tea limited edition. First frame is image 1: your hand picks a dewy Aksu red apple with a crisp apple collision sound. 2-4s: quick cut, your hand drops apple chunks into a shaker cup, adds ice and tea base, shakes vigorously, ice collision and shaking sounds sync with upbeat drum beats, background voice: 'Fresh-cut, fresh-shaken'. 4-6s: first-person close-up of the finished product, layered fruit tea poured into a clear cup, your hand gently squeezes cream cap spreading on top, sticks a pink label on the cup, camera zooms in on the layered texture of cream cap and fruit tea. 6-8s: first-person handheld cup raise, you lift the fruit tea from image 2 toward the camera (simulating handing it to the viewer), cup label clearly visible, background voice 'Take a sip of freshness', final frame freezes on image 2. Background voice consistently uses a female tone.",
  "image_urls": [
    "https://example.com/tea_pic1.jpg",
    "https://example.com/tea_pic2.jpg"
  ],
  "video_urls": ["https://example.com/tea_video1.mp4"],
  "audio_urls": ["https://example.com/tea_audio1.mp3"],
  "generate_audio": true,
  "size": "16:9",
  "duration": 11
}
```

### Caso 10: Imagen-a-video con Asset URL

Los assets de avatar virtual aprobados pueden pasarse directamente como imágenes de referencia sin volver a subirlos ni someterlos a revisión nuevamente.

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "The character walks naturally on a city street under bright sunshine",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}
```

### Caso 11: Especificar retrato de referencia con Asset URL (image\_with\_roles)

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "Using the reference portrait, the character walks elegantly toward the camera",
  "image_with_roles": [
    {
      "url": "asset://asset_a",
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "duration": 5
}
```

### Caso 12: Versión rápida + imagen-a-video con Asset URL

```json theme={null}
{
  "model": "seedance-2.0-fast",
  "prompt": "The character strolls in a park with a gentle breeze",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}
```

### Caso 13: Imagen con Asset URL + video de referencia (transferencia de movimiento)

Combine un asset de retrato aprobado con un video de referencia para que el personaje realice los movimientos especificados.

```json theme={null}
{
  "model": "seedance-2.0",
  "prompt": "The character dances to the rhythm of the reference video with smooth and natural movements",
  "image_urls": ["https://example.com/dance_reference.jpg", "asset://asset_a"],
  "video_urls": ["https://example.com/dance_reference.mp4", "asset://asset_a"],
  "duration": 8,
  "resolution": "720p"
}
```

> [!NOTE]
>
> **Consultar los resultados de la tarea**
>
> La generación de video es una tarea asíncrona que devuelve un `task_id` al enviarla. Use el endpoint [Obtener estado de tarea](https://gccai.heqingsong.uk/es/api-reference/tasks/status.md) para consultar el progreso y los resultados de la generación.

## Diferencias con la versión 1.5 Pro

| Característica | 1.5 Pro | 2.0 / 2.0 fast |
| - | - | - |
| Resolución | 480p/720p/1080p | **480p/720p/1080p/4k** (fast solo 480p/720p) |
| Rango de duración | 4-12s | **5-15s** |
| Duración predeterminada | 5s | **5s** |
| Parámetro de proporción | `aspect_ratio` | **`size`** (nueva opción `adaptive`) |
| Generación de audio | parámetro `audio` | **parámetro `generate_audio`** |
| Video de referencia | No admitido | **Admitido vía `video_urls`** |
| Audio de referencia | No admitido | **Admitido vía `audio_urls`** |
| Imagen-a-video | `image_urls` / `image_with_roles` | **`image_urls` / `image_with_roles`** |
| Video con audio | No admitido | **Admitido vía `generate_audio`** |
| Video continuo | No admitido | **Admitido vía `return_last_frame`** |
| Versión rápida | No admitida | **Admitida vía `seedance-2.0-fast`** |


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