kling-3.0-turbo API

Utilice el ID de modelo exacto kling-3.0-turbo. El campo del modelo debe coincidir exactamente con esta página.

Salida de muestrakling-3.0-turboPOST /v1/videos5.0s

Parámetros: duration=5resolution=1080pratio=16:9

Prompt: A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, no text.

Solicitud que produjo esta muestra

{
  "model": "kling-3.0-turbo",
  "prompt": "A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Autenticación y punto final

Utilice una clave API de Modelflare con https://modelflare.dev/v1. El punto de entrada de la puerta de enlace es POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Crear una tarea

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "settings": {"duration": 5, "resolution": "720p"}
  }'

Encuesta y descarga

Guardar el ID de la tarea. Sondear GET /v1/videos/{task_id} y descargar con GET /v1/videos/{task_id}/content. Las URL de resultados pueden caducar, así que transfiera el archivo lo antes posible.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Solicitar notas

Kling utiliza campos model_name, prompt, mode, duration, image_list o contents / settings específicos de la familia; El JSON nativo se conserva y reenvía.

Solicitar parámetros

Kling 3.0 Turbo selecciona el modelo en la ruta URL; no ponga model_name en el cuerpo. La conversión de texto a vídeo y de imagen a vídeo del primer fotograma utilizan rutas oficiales diferentes.

Campo	Requerido	Notas
prompt	Sí	Mensaje de texto a video; utilizar el límite de longitud oficial
contents[]	Condicional	Para imagen a video, incluya prompt y first_frame
settings.resolution	No	720p / 1080p
settings.aspect_ratio	No	16:9 / 9:16 / 1:1
settings.duration	No	3–15 segundos
options.watermark_info	No	Configuración de marca de agua

Límites de entrada y salida

Texto a vídeo e imagen a vídeo del primer fotograma utilizan prompt y contents[] respectivamente. La salida es de 720p o 1080p durante 3 a 15 segundos; Los avisos de disparos múltiples admiten hasta seis disparos.

Ejemplos de flujos de trabajo documentados

Turbo utiliza la envolvente contents/settings/options actualizada. El ID del modelo permanece en el campo model de Modelflare y las llamadas ingresan a través de /v1/videos.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "contents": [{"type": "prompt", "text": "列车缓慢驶过雨夜城市"}],
    "settings": {"resolution": "1080p", "aspect_ratio": "16:9", "duration": 5},
    "options": {"watermark_info": {"enabled": false}}
  }'

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "contents": [{"type": "prompt", "text": "角色转身看向窗外"}, {"type": "first_frame", "url": "https://example.com/first.png"}],
    "settings": {"resolution": "1080p", "duration": 5}
  }'

Errores y tareas fallidas

Los parámetros del modelo no válidos devuelven un 4xx con un ID de solicitud. Una tarea asincrónica también puede fallar después de que la creación sea exitosa; utilice error_code y error_message de la respuesta de la encuesta como motivo final de la tarea. No vuelva a intentar la misma solicitud con una forma JSON diferente.

Alcance soportado

Esta página cubre las llamadas de generación y edición de modelos de Modelflare. El enriquecimiento de mapas o búsquedas, la administración de voz y la administración de bibliotecas de elementos son API de recursos fuera de esta superficie pública de llamada de modelo y no son campos de solicitud obligatorios.

Precios y facturación

Este modelo utiliza facturación de video por segundo. Consulte la página de precios de modelos para conocer el precio actual para el cliente, el precio de lista de referencia y las especificaciones completas.

Nota

Esta página documenta la interfaz pública de Modelflare; Los campos y límites que se muestran aquí son el contrato actual.