Kling V4 Flash

Contrato APIMaster de kling-v4-flash, verificado el 2026-11-07. Canal 317: texto, primer fotograma, referencias, edición y extensión. Solo 720p, 24 fps, 3–20 segundos; modelo distinto de Kling V4.

Kling V4 Flash

Rutas y autenticación

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

Parámetros

Use JSON y Authorization: Bearer YOUR_API_KEY. model debe ser kling-v4-flash. prompt obligatorio salvo con una sola imagen inicial. duration/seconds: enteros JSON 3–20, predeterminado 5; null equivale a omitir, 0 se rechaza. Ambos alias deben ser válidos e iguales. La edición sin duración redondea hacia arriba la duración del flujo de vídeo. resolution solo 720p. aspect_ratio o size: 16:9, 9:16, 1:1, 21:9; auto solo para referencias. Valores predeterminados: texto 16:9, referencias auto, edición según la entrada. Imagen inicial y extensión rechazan aspect_ratio/size no vacíos. audio solo true, watermark solo false.

Parámetro	Tipo JSON	Obligatorio	Predeterminado	Función y límites
model	string	Sí	kling-v4-flash	Siempre kling-v4-flash para las cinco operaciones; kling-v4 es otro modelo.
prompt	string	Según el modo	—	Describe escena, movimiento o cambios. Solo es opcional con una imagen inicial. @Image1 y @Video1 se numeran por separado desde 1 según cada matriz; el vídeo editado es @Video1.
duration	integer / null	No	5	Entero JSON de 3–20 segundos, normalmente 5. Edición sin ambos campos redondea hacia arriba la duración de la pista de vídeo original; extensión indica el segmento NUEVO. null equivale a omitir; se rechazan 0, valores no enteros y cadenas numéricas.
seconds	integer / null	No	—	Alias de duration con iguales límites. Se recomienda uno solo; si se envían ambos deben ser válidos e iguales, de lo contrario 400.
resolution	string	No	720p	Solo 720p. Nivel de calidad, no garantía de lado corto de 720px. No se admiten 1080p ni selección de calidad mediante mode.
aspect_ratio	string	No	Según el modo	Texto/referencia/edición: 16:9, 9:16, 1:1, 21:9; auto solo para referencias. Predeterminado: texto 16:9, referencia auto, edición según origen. Imagen inicial/extensión rechazan valores no vacíos; cadena vacía equivale a omitir.
size	string	No	—	Alias de aspect_ratio, no resolución ni tamaño de píxeles. Ambos campos deben coincidir. Omitir los dos para imagen inicial y extensión.
image_urls	string[]	Según el modo	—	Matriz de URL públicas de imágenes. Auto acepta una imagen inicial; referencias solo de imágenes exigen reference explícito. Referencia/edición: ≤10 imágenes contando roles reference_image. No mezclar representaciones del primer fotograma; extensión no acepta imágenes.
first_frame_image	string	Según el modo	—	URL pública de la única imagen inicial, alternativa a un elemento image_urls o al rol first_frame. Ambos lados ≥300px, proporción 2:5–5:2; recortar antes si hace falta.
image_with_roles	{url, role}[]	Según el modo	—	Cada objeto requiere url pública y role. first_frame para el único fotograma inicial, reference_image para referencia/edición. Sin fotogramas finales/intermedios/clave. ≤10 imágenes de referencia y ≤15 referencias imagen/vídeo en total.
video_url	string	Según el modo	—	URL pública de un vídeo fuente con edit/extend explícito, excluyente con video_urls. Edición: MP4/MOV, pista 3–20s, cada dimensión 700–4553px. Extensión desde el último fotograma, devolviendo solo el tramo nuevo; no usar ID de tarea/conversación.
video_urls	string[]	Según el modo	—	Hasta 5 MP4/MOV de referencia, cada pista≥3s, cada dimensión 700–4553px, suma≤20s. Edit/extend explícitos pueden usar un elemento en lugar de video_url. Se rechaza el exceso sin recortar; esta matriz selecciona referencia automáticamente.
omni_reference_task_type	string	No	auto	auto deduce texto/imagen inicial/referencia; reference requiere material de referencia; edit/extend requieren exactamente un vídeo. video_url sin modo explícito y dos imágenes normales en auto son inválidos.
audio_setting	string	No	auto	Solo referencias CON VÍDEO. auto genera sonido; origin conserva el de la PRIMERA referencia, y sin pista en esa fuente tampoco habrá pista de salida. Omitir para edición, extensión, texto y referencias solo de imágenes.
audio	boolean	No	true	Booleano de compatibilidad: omitir o true; false se rechaza. Conservar sonido mediante audio_setting en modos admitidos. No se admiten audios de referencia separados.
watermark	boolean	No	false	Booleano de compatibilidad: omitir o false; true se rechaza. No elimina marcas de agua del material original.

URL HTTP(S) públicas directas sin credenciales incrustadas; no base64/rutas locales/ID de tarea. No se publican por separado formatos o límites de bytes de imágenes. 100MiB limita la lectura de cada vídeo analizado para referencia/edición, no todas las cargas del proveedor.

Modos y medios

Operación	Selección y material requerido	Predeterminados y exclusiones
Texto a vídeo	Sin material; prompt obligatorio, tipo auto u omitido.	5s, 16:9; sin audio_setting.
Imagen inicial a vídeo	Una imagen mediante UNA de tres representaciones; prompt opcional.	5s, proporción de la imagen; sin aspect_ratio/size ni fotograma final.
Referencia a vídeo	reference + imágenes, roles reference_image o video_urls; prompt obligatorio.	5s, auto; imágenes≤10, vídeos≤5, total≤15; opción sonora solo con vídeo.
Edición	edit + un vídeo, prompt obligatorio; hasta 10 imágenes de referencia.	Duración fuente redondeada hacia arriba, proporción fuente; sin roles de fotogramas/audio_setting.
Extensión	extend + un vídeo, prompt obligatorio.	5 segundos NUEVOS; sin imágenes, cambio de proporción/audio_setting; no se aplican mínimos de tamaño/duración de edición/referencia.

omni_reference_task_type: auto, reference, edit, extend. Una imagen image_urls, first_frame_image o un rol first_frame activa imagen a vídeo. Varias referencias requieren reference o roles reference_image; dos image_urls en auto se rechazan. video_urls usa referencias salvo edit/extend explícito. video_url exige edit/extend y excluye video_urls. Edición/extensión requieren un vídeo. La edición admite imágenes de referencia; la extensión rechaza imágenes/audio_setting y devuelve solo el segmento NUEVO. Use una URL pública del vídeo original, no un ID de tarea o conversación.

URLs HTTP(S) públicas directas sin credenciales. Hasta 10 imágenes, 15 referencias de imagen/vídeo en total. Imágenes de al menos 300×300, proporción 2:5–5:2. Hasta 5 MP4/MOV, cada uno de al menos 3 segundos, total máximo 20; edición: un vídeo de 3–20 segundos. Ancho Y alto entre 700 y 4553 píxeles. El gateway lee hasta 100 MiB por vídeo y mide el flujo de vídeo, no contenedor/audio. Estos límites de dimensiones y duración mínima no se aplican a la entrada de extensión. El proveedor también valida las imágenes. audio_setting=origin conserva sonido del primer vídeo de referencia o silencio; auto genera sonido. Solo con referencias de vídeo. La edición genera sonido nuevo. Sin URLs de audio, fotograma final/intermedio, keyframes, negative_prompt, mode, seed, escenas múltiples ni listas de personajes/voces.

Píxeles de salida y fotogramas por segundo

Proporción / operación	Píxeles documentados	Frecuencia
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
Imagen inicial a vídeo	Según proporción de imagen, unos 0,92MP; p. ej. 604×1516 para 2:5.	24 fps

Las dimensiones de salida no son requisitos de entrada. El 21:9 tiene 628px de alto, menos de 700px para referencia/edición: prepara material válido. Ese mínimo no se aplica a extensión. El archivo puede durar aproximadamente un fotograma más.

Ejemplos sin ejecución

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

Facturación

Base oficial nominal: $0.094 por segundo de salida (720P), $0.0628 por segundo facturable con vídeo (720P-input). Texto, imagen, referencias sin vídeo y extensión: salida/segmento nuevo. Referencias de vídeo y edición: salida + max(entrada, salida). Sume primero las duraciones de los flujos de entrada y después redondee la suma hacia arriba. Entrada 3.04 s y salida 3 s: 3+max(4,3)=7 segundos facturables. Un fotograma extra no modifica la duración entera solicitada. Descuentos de paquetes y coeficientes de cuenta son independientes; consulte la tarjeta y el importe final del registro. Un fallo confirmado devuelve la reserva. Dejar de consultar no cancela la tarea; un timeout ambiguo no justifica generar de nuevo.

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

Consulta, errores y reintentos seguros

Primera aceptación: HTTP 200, task_id público, queued. GET /v1/videos/{task_id}: queued/in_progress/completed/failed, posible unknown temporal. url y metadata.url requieren Bearer; también GET /v1/videos/{task_id}/content. Fallo: error.code=generation_failed con mensaje saneado; parámetros inválidos: HTTP 400. Idempotency-Key: 8–128 caracteres ASCII visibles sin espacios. Misma cuenta/clave/petición: HTTP 202 sin generación/reserva adicional; cambios: 409. GET /v1/video-submissions/by-key lee el recibo. accepted+task_ready=true: consultar task_id; pending/submitting o no listo: esperar. acceptance_unknown: conserve clave y contacte soporte, sin reenvío automático. Un 404 no prueba no aceptación. Retención mínima 30 días; protección del gateway, sin búsqueda en el proveedor. Importe final en consumo por other.task_id; la consulta no garantiza factura. /v1/videos/quote no está admitido. Ejemplos inertes: sustituya URLs y use clave nueva para cada operación nueva.

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI