Kuaishou

Kling 3.0

kling-3.0-omni/transformation

Serie unificada de generación de vídeo multimodal que admite texto a vídeo, imagen a vídeo, referencia a vídeo y edición dentro del vídeo, con sincronización labial nativa y audio multilingüe

kling-3.0-omni/image-to-video kling-3.0-omni/reference-to-video kling-3.0-omni/text-to-video kling-3.0-omni/transformation kling-3.0/image-to-video kling-3.0/motion-control kling-3.0/text-to-video

Probar kling-3.0-omni/transformation

Entrada

Subjects

Creaciones

Ver todas las creaciones

Salida

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

kling-3.0-omni/transformation per second

Especificaciones	Precio unitario
720P	$0.143
1080P	$0.193
4K	$0.479

Descripción general

La línea de transformación de vídeo de Kling 3.0 Omni está dirigida a desarrolladores que necesitan realizar una segunda creación sobre material existente. Basta con introducir un vídeo de origen de 3 a 15,5 segundos y una descripción textual para reescribir el contenido del vídeo según la descripción; la duración y el formato de salida siguen al vídeo de origen, y se puede elegir resolución de 720p, 1080p o 4K. Permite referenciar hasta 7 sujetos reutilizables con @nombre en el prompt, cada uno definido por 2 a 4 imágenes, lo que resulta adecuado para tareas de reescritura que requieren mantener la coherencia de personas u objetos. Se invoca a través de la interfaz unificada de HiAPI.ai.

Puntos clave

Reescritura basada en el vídeo de origen, no generación desde cero: la duración y la relación de aspecto de la salida heredan las del vídeo de origen, de modo que la estructura de la imagen tiene una base concreta, lo que resulta adecuado para recrear de forma dirigida material ya existente.
El prompt puede referenciar sujetos con nombre: se pueden registrar hasta 7 sujetos, cada uno descrito con 2 a 4 imágenes, y se invocan con @nombre en el prompt, lo que facilita mantener la misma apariencia entre planos.
Resolución seleccionable hasta 4K: la salida ofrece tres niveles, 720p, 1080p y 4k, para elegir la nitidez según el canal de distribución.

Descripción de capacidades

Reescritura dirigida del vídeo de origen: sube un vídeo de origen MP4 o MOV (máximo 200MB, de 3 a 15,5 segundos, de 700 a 4553 píxeles, de 24 a 60 fps), transforma el contenido según el prompt y la salida conserva la duración y el formato del vídeo de origen.

Referencia de múltiples sujetos: proporciona de 2 a 4 imágenes JPG o PNG de un mismo sujeto y asígnales un nombre, hasta 7 grupos, y refiérete a ellos con @nombre en el prompt, lo que reduce el coste de describir textualmente la apariencia de los sujetos.

Selección de nivel de resolución: la salida puede ser 720p, 1080p o 4k, con 720p por defecto, lo que facilita sopesar nitidez y coste de generación según el uso.

Control de longitud del prompt: el prompt admite hasta 3072 caracteres, suficiente para instrucciones de reescritura de contenido bastante completas manteniendo un solo bloque controlable.

Casos de uso

Equipos de publicidad y marketing que reescriben cortos existentes: transforma material rodado o generado existente en distintas versiones creativas y produce cortometrajes listos para publicar.
Operaciones de e-commerce que sustituyen la imagen de presentación del producto: toma un vídeo corto del producto como vídeo de origen y reescribe la escena o la forma de presentación según el prompt para obtener un vídeo de presentación ajustado a la página del producto.
Equipos de contenido que reutilizan material de personajes: tras registrar un sujeto de personaje fijo, referéncialo con @nombre en múltiples tareas de transformación y produce series de vídeos con una apariencia coherente.

Limitaciones y recomendaciones de selección

Esta línea solo acepta un vídeo de origen, y la salida conserva su duración y formato, por lo que los contenidos largos deben procesarse por segmentos; el vídeo de origen debe cumplir restricciones como 3 a 15,5 segundos y un máximo de 200MB, y no se puede usar directamente si se excede el rango; las especificaciones indican claramente que no se genera audio, por lo que las imágenes que necesiten sonido deben tratarse por separado. Si la tarea consiste en generar desde cero o en convertir una imagen en vídeo, se puede recurrir a las líneas de texto a vídeo e imagen a vídeo de la misma serie; si se necesita un control preciso del movimiento, conviene considerar la línea de control de movimiento.

Novedades

Ver el registro de cambios →

Nuevo modelo Nuevo modelo: Kling 3.0 Omni (可灵 O3), se invoca mediante POST /v1/tasks. kling-3.0-omn… Oct 12, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Kling 3.0 Image-to-Video requiere subir una imagen?

Sí. Actualmente kling-3.0/image-to-video es una ruta de video a partir de imagen; la imagen de entrada define el sujeto y la composición inicial, y el Prompt define la acción, el movimiento de cámara y los cambios del entorno.
¿Qué duraciones y resoluciones admite Kling 3.0 Image-to-Video?

El contrato de solicitud actual de HiAPI admite de 3 a 15 s, con resoluciones de salida de 720p, 1080p y 4K. Los valores disponibles están sujetos al panel de parámetros de la página y a la documentación de la API.
¿Cómo se factura Kling 3.0 Image-to-Video?

La tarea se factura según la duración de salida y el nivel seleccionado. La página muestra el precio en tiempo real siguiendo la unidad monetaria global, y el cargo final se basa en el registro de la tarea completada correctamente.
¿Cómo mejorar la estabilidad del sujeto en la generación de video a partir de imágenes?

Utiliza una imagen de entrada con un sujeto claro, pocas oclusiones y una composición completa; en el Prompt, describe primero la acción principal y el plano, y luego enumera la apariencia, los materiales y la relación con el fondo que deben conservarse. Para la primera prueba, se recomienda usar una duración más corta.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: kling-3.0-omni/transformation

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para kling-3.0-omni/transformation y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 3072

Texto de descripción del video, utilizado para explicar el contenido del video que se desea generar; si es necesario hacer referencia a un sujeto de entrada, mencionar el nombre del sujeto correspondiente en el texto en la forma @name.

elementsarrayOpcionalmaxItems 7

Arreglo de sujetos reutilizables, máximo 7; cada elemento consta de un nombre, una descripción breve y de 2 a 4 imágenes, y se puede referenciar en el prompt mediante @name.

Array [ object ]

Elementos del array

namestringObligatoriominLength 1

Nombre del sujeto, utilizado como identificador de referencia @name en el prompt; debe ser único y no contener espacios.

descriptionstringObligatoriominLength 1

Descripción textual breve de dicho sujeto, utilizada para ayudar al modelo a comprender las características del sujeto.

element_input_urlsarrayObligatoriominItems 2maxItems 4

Arreglo de imágenes del mismo sujeto; se deben proporcionar de 2 a 4, en formato JPG o PNG.

Array [ string ]

resolutionstringOpcionalPredeterminado: "720p"

Resolución del video de salida; por defecto 720p.

Opciones:720p1080p4k

video_urlsarrayObligatoriominItems 1maxItems 1

Arreglo de videos de origen que se van a convertir; admite MP4 o MOV, máximo 200MB, duración de 3-15.5 segundos, ancho y alto de 700-4553 píxeles, velocidad de fotogramas de 24-60 fps; la duración y la relación de aspecto del video de salida siguen al video de origen, y no se genera audio.

Array [ string ]

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-3.0-omni/transformation",
  "input": {
    "prompt": "…",
    "resolution": "720p",
    "video_urls": "…"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "kling-3.0-omni/transformation",
    input: {
      "prompt": "…",
      "resolution": "720p",
      "video_urls": "…"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "kling-3.0-omni/transformation",
        "input": {
          "prompt": "…",
          "resolution": "720p",
          "video_urls": "…"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}