Kling 3.0 Omni API
Kling 3.0 Omni, modelo de vídeo multimodal unificado: vídeos desde texto, fotogramas inicial y final, o hasta 7 imágenes o sujetos de referencia, hasta 4K y de 3 a 15 segundos
- 720p · sin audio
- APIMart 0,0672 $ / segundo
- Oficial
0,084 $20% menos - 720p · con audio
- APIMart 0,0896 $ / segundo
- Oficial
0,112 $20% menos - 1080p · sin audio
- APIMart 0,0896 $ / segundo
- Oficial
0,112 $20% menos - 1080p · con audio
- APIMart 0,112 $ / segundo
- Oficial
0,14 $20% menos
Comparar precios
Compara los precios públicos de los proveedores para la misma especificación de salida
Enrutamiento automático y failover
Llama a Kling 3.0 Omni con un solo ID de modelo y Yir elige el canal de cada tarea entre APIMart, KIE y FAL: la envía al canal disponible con el precio estimado más bajo y la cobra al precio público de ese canal, sin recargo. Si un intento falla, lo reintenta en otro canal sin superar tu max_cost. No necesitas parámetros de enrutamiento en tu solicitud. Documentación de enrutamiento y failover
Notas de precios
Se cobra según el proveedor que realmente ejecuta la tarea. El failover puede cambiar de proveedor, lo que puede modificar el costo y el tiempo.
Usar la API
Deja el código a un agente de programación, genera en el chat con MCP o la Skill, o intégralo tú mismo con el SDK o la API compatible con OpenAI.
Deja que un agente de programación lo integre
Copia el prompt de integración o ábrelo directamente en Codex o Claude. El agente lee esta página y el contrato del modelo, y luego escribe en tu proyecto el envío, la espera y el manejo de resultados.
Añade el servidor MCP de Yir
Conéctalo a ChatGPT, Claude o Cursor, menciona @Yir y pide Kling 3.0 Omni por su nombre. Primero te da el precio y solo genera cuando confirmas.
https://gateway.yir.ai/mcpUn comando para Claude Code
Crea una API key en la consola, guárdala como YIR_API_KEY y ejecuta:
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Instala la Skill de Yir
Define YIR_API_KEY donde se ejecuta tu agente, añade la Skill a Claude Code, Codex u otro agente de programación y di “usa Kling 3.0 Omni en Yir para crear…”.
npx skills add yir-ai/skillsInstala el SDK oficial con tu gestor de paquetes o copia el fragmento de código de abajo para empezar
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // Lee YIR_API_KEY del entorno por defecto: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. Envía una tarea de generación de video |
| const job = await client.submitVideo({ |
| model: "klingai/kling-3.0-omni", |
| input: { |
| type: "text", |
| prompt: "Una tortuga marina nada despacio sobre un arrecife de coral. La cámara la sigue suavemente de lado mientras la luz del sol atraviesa el agua clara y proyecta reflejos en movimiento sobre su caparazón", |
| }, |
| parameters: { |
| duration: 5, |
| resolution: "720p", |
| aspect_ratio: "16:9", |
| generate_audio: false, |
| n: 1, |
| }, |
| }); |
| // 2. Espera a que la tarea termine y entregue el resultado |
| const result = await client.waitForJob(job.id); |
| console.log("Archivos entregados:", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
Los proyectos que ya usan el protocolo de OpenAI, o gateways como new-api, solo necesitan una nueva Base URL y una nueva clave. Guía de compatibilidad con OpenAI
- base_url del SDK de OpenAI
https://gateway.yir.ai/openai/v1- Base URL del canal en new-api
https://gateway.yir.ai/openai- Clave
- API Key de Yir
- ID del modelo
klingai/kling-3.0-omni
curl https://gateway.yir.ai/openai/v1/videos \
-H "Authorization: Bearer $YIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "klingai/kling-3.0-omni",
"prompt": "Una tortuga marina nada despacio sobre un arrecife de coral. La cámara la sigue suavemente de lado mientras la luz del sol atraviesa el agua clara y proyecta reflejos en movimiento sobre su caparazón",
"resolution": "720p",
"aspect_ratio": "16:9",
"seconds": "5"
}'Resumen de parámetros
Parámetros comunes; los límites dependen del modelo actual y del proveedor seleccionado
- Resolución resolution
- 720p
- 1080p
- 4K
Nivel de resolución de salida. Las resoluciones más altas dan mayor nitidez y el precio aumenta en consecuencia
- Relación de aspecto aspect_ratio
- 16:9
- 9:16
- 1:1
Proporción geométrica. Elígela según el medio de destino (vertical, banner o cuadrado)
- Modo de entrada input_mode
- Entrada de texto
- Entrada de referencias
- Entrada de imagen
Los límites y formatos de las referencias dependen del modelo y del proveedor seleccionado
- Duración duration
- 3–15 segundos
Nivel de duración del video de salida, cobrado por segundo o por tramos
- Audio generate_audio
- Opcional
Pista de audio nativo sincronizado opcional
- Referencias references
- first_frame ≤ 1
- last_frame ≤ 1
- reference_image ≤ 7
Hasta 7 personajes: asigna el mismo nombre de subject a 2–4 imágenes y llámalo por su nombre en el prompt





