Kuaishou

Kling 3.0 Turbo

kling-3.0-turbo/image-to-video

Modelo de generación de video orientado a vistas previas rápidas e iteraciones frecuentes, compatible tanto con texto a video como con imagen a video; puede generar clips de 1 a 15 segundos en 480p–1080p, y en imagen a video admite hasta 7 imágenes de referencia

kling-3.0-turbo/image-to-video kling-3.0-turbo/text-to-video

Probar kling-3.0-turbo/image-to-video

Entrada

Creaciones

Ver todas las creaciones

Salida

video

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

Precios

kling-3.0-turbo/image-to-video per second

Especificaciones	Precio unitario
720P	$0.130
1080P	$0.160

Descripción general

kling-3.0-turbo/image-to-video es la ruta de imagen a vídeo de la serie Kling 3.0 Turbo de Kuaishou, invocada a través de la interfaz unificada de HiAPI.ai. Toma una única imagen como fotograma inicial como ancla y, combinada con un prompt de texto, genera vídeos de 3 a 15 segundos, con salida seleccionable en 720p o 1080p. El prompt admite hasta 2500 caracteres y permite marcar diálogos entre comillas para generar líneas de voz con sincronización labial. Su enfoque es la generación rápida de clips y la iteración de múltiples versiones: resulta adecuado para desarrolladores que necesitan obtener rápidamente una vista previa dinámica a partir de una imagen estática y probar movimientos de cámara y direcciones de movimiento del sujeto, no para producir directamente un montaje final de alta calidad.

Aspectos destacados

Impulsado por un único fotograma inicial, con resultados controlables: basta una imagen inicial en jpeg/png y un prompt para generar el clip; el sujeto y la composición quedan fijados por la imagen, lo que reduce la aleatoriedad de la descripción textual.
Diálogo con sincronización labial integrado en el prompt: el prompt permite marcar diálogos entre comillas y generar fragmentos de habla con sincronización labial, lo que ahorra los pasos previos de doblaje y ajuste de pista adicional.
Duración y resolución ajustables según necesidad: la duración de salida es ajustable entre 3 y 15 segundos, y la resolución se alterna entre 720p y 1080p, de modo que la vista previa y el cuasi-montaje final pueden completarse con el mismo modelo.

Descripción de capacidades

Imagen a vídeo desde el fotograma inicial: se introduce una única imagen inicial en jpeg/png (máximo 10MB, no compatible con SVG) junto con un prompt, y el modelo genera el movimiento posterior siguiendo el sujeto y la composición de la imagen, lo que garantiza que el punto de partida del plano coincida con lo esperado.

Sincronización de diálogo y labios: en el prompt pueden escribirse líneas de diálogo entre comillas, y el fragmento generado mostrará los movimientos labiales correspondientes, apropiado para material breve de locución con personas en pantalla.

Control de duración y resolución: la duración se establece en números enteros entre 3 y 15 segundos, con 5 segundos por defecto; la resolución puede ser 720p o 1080p, eligiendo el nivel de nitidez según el destino de publicación.

Respuesta a prompts detallados: el prompt admite hasta 2500 caracteres, lo que permite describir por completo las acciones del sujeto, la atmósfera de la escena y la dirección de cámara, intercambiando una descripción más larga por un movimiento más cercano a lo esperado.

Casos de uso

Equipos de diseño y marketing que validan direcciones creativas: usar una imagen de producto o de escena como fotograma inicial para generar rápidamente varias versiones de vistas previas dinámicas, destinadas a la revisión interna y a la confirmación de dirección antes de presentar propuestas a clientes.
Producción de prueba por lotes de variantes de vídeos cortos para redes sociales: a partir de una misma imagen inicial de una persona o un producto, ajustar el prompt para producir varios clips cortos y seleccionar antes de la publicación las versiones con mejor rendimiento.
Pruebas de movimiento de cámara y dirección de movimiento del sujeto: usar una imagen estática como punto de partida para probar efectos de movimiento con distintas descripciones de plano y definir el plan de rodaje y storyboard de la producción formal posterior.
Material de locución con diálogo y persona en pantalla: usar una imagen de retrato como fotograma inicial y escribir diálogos entre comillas en el prompt para generar clips breves de locución con coincidencia labial, utilizables como gancho publicitario o material para feeds.

Limitaciones y recomendaciones de selección

Su enfoque es la generación rápida de clips y la iteración de vistas previas; el detalle de imagen y la consistencia entre planos no lo hacen adecuado como montaje final de alta calidad directo. Los proyectos que requieran storyboard estricto y consistencia de personajes deberían evaluar modelos de nivel Pro. La documentación consultada no confirma salida de audio nativo, por lo que la música o la mezcla del montaje final deben gestionarse por separado. El resultado es bastante sensible al nivel de detalle del prompt, y las descripciones demasiado breves ofrecen una estabilidad limitada. El fotograma inicial solo admite una única imagen, sin referencia de múltiples imágenes. Los parámetros realmente disponibles dependen de la configuración actual de la ruta de HiAPI.ai.

Preguntas frecuentes

Ver todas las preguntas →

¿El modelo Kling 3.0 Turbo de texto a video requiere subir una imagen?

No. La página actual corresponde al modelo de texto a video puro kling-3.0-turbo/text-to-video, que solo acepta un Prompt de texto. Si necesitas generar un video a partir de un primer fotograma, debes usar la página independiente del modelo Kling 3.0 Turbo Image-to-Video.
¿Qué duraciones, resoluciones y relaciones de aspecto admite Kling 3.0 Turbo?

El contrato de solicitud actual de HiAPI admite de 3 a 15 segundos, 720p o 1080p, y 16:9, 9:16, 1:1. Los ejemplos de la página cubren 720p, 5 segundos y 12 segundos, horizontal y vertical; 1080p y 1:1 son capacidades admitidas por la interfaz, pero la página aún no cuenta con ejemplos correspondientes.
¿Cómo se factura la generación de video a partir de texto con Kling 3.0 Turbo?

Se factura según la duración y la resolución del video generado; 720p y 1080p usan distintas tarifas por segundo. El monto exacto se rige por el precio en tiempo real de la página y el registro de tareas.
¿Cómo escribir un prompt de texto a video para Kling 3.0 Turbo?

Primero escribe el sujeto y la escena, luego describe la acción y el movimiento de cámara en orden, y finalmente añade los requisitos de iluminación, estilo y estabilidad. Para los planos largos, especifica claramente single continuous shot, no cuts y la trayectoria de cámara; en el caso de contenido vertical, también debes indicar vertical en el prompt y establecer aspect_ratio en 9:16.

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-turbo/image-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para kling-3.0-turbo/image-to-video y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 2500

Descripción textual para generar el video, con una longitud máxima de 2500 caracteres; permite escribir diálogos entre comillas para lograr la sincronización labial del habla.

durationintegerOpcionalPredeterminado: 5min 3max 15

Duración del video generado, en segundos; el rango de valores es de 3 a 15, por defecto 5.

image_urlsarrayObligatoriominItems 1maxItems 1

Arreglo de URL de imágenes del primer fotograma; solo admite una única imagen, en formato jpeg o png, con un máximo de 10 MB por imagen; no admite SVG.

Array [ string ]

resolutionstringOpcionalPredeterminado: "720p"

Resolución del video generado; por defecto 720p.

Opciones:720p1080p

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-turbo/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "image_urls": "…",
    "resolution": "720p"
  }
}'

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-turbo/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "image_urls": "…",
      "resolution": "720p"
    }
  }),
});
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-turbo/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "image_urls": "…",
          "resolution": "720p"
        }
    },
)
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"
    }
  }
}