Kling 3.0 Omni API

Kling 3.0 Omni, modelo de vídeo multimodal unificado: vídeos a partir de texto, quadros inicial e final, ou até 7 imagens ou sujeitos de referência, até 4K e de 3 a 15 segundos

720p · sem áudio
APIMart $ 0,0672 / segundo
Oficial$ 0,08420% mais barato
720p · com áudio
APIMart $ 0,0896 / segundo
Oficial$ 0,11220% mais barato
1080p · sem áudio
APIMart $ 0,0896 / segundo
Oficial$ 0,11220% mais barato
1080p · com áudio
APIMart $ 0,112 / segundo
Oficial$ 0,1420% mais barato

Comparar preços

Compare os preços públicos dos canais para a mesma especificação de saída

Comparar outros modelos
Especificação de saídaCanaisPreço publicado pelo canalTempo típicoTestar
720p · sem áudio
Kling AIOficial
$ 0,0840 / segundo
Apenas preço de referência; não disponível pelo Yir
FAL
$ 0,0840 / segundo
Testar
KIE
$ 0,0755 / segundo10% mais barato
Testar
APIMart
$ 0,0672 / segundo20% mais barato
Testar
720p · com áudio
Kling AIOficial
$ 0,1120 / segundo
Apenas preço de referência; não disponível pelo Yir
FAL
$ 0,1120 / segundo
Testar
KIE
$ 0,1010 / segundo10% mais barato
Testar
APIMart
$ 0,0896 / segundo20% mais barato
Testar
1080p · sem áudio
Kling AIOficial
$ 0,1120 / segundo
Apenas preço de referência; não disponível pelo Yir
FAL · pro
$ 0,1120 / segundo
Testar
KIE
$ 0,1010 / segundo10% mais barato
Testar
APIMart
$ 0,0896 / segundo20% mais barato
Testar
1080p · com áudio
Kling AIOficial
$ 0,140 / segundo
Apenas preço de referência; não disponível pelo Yir
FAL · pro
$ 0,140 / segundo
Testar
KIE
$ 0,126 / segundo10% mais barato
Testar
APIMart
$ 0,112 / segundo20% mais barato
Testar
4K
Kling AIOficial
$ 0,4200 / segundo
Apenas preço de referência; não disponível pelo Yir
APIMart
$ 0,4286 / segundo2% mais caro
Testar
FAL · native4k
$ 0,4200 / segundo
Testar
KIE
$ 0,3775 / segundo10% mais barato
Testar

Roteamento automático e failover

Chame o Kling 3.0 Omni com um único ID de modelo e a Yir escolhe o canal de cada job entre APIMart, KIE e FAL: ele vai para o canal elegível com o menor preço estimado e é cobrado pelo preço público desse canal, sem markup. Se uma tentativa falhar, a Yir tenta de novo em outro canal sem passar do seu max_cost. Não é preciso parâmetro de roteamento na solicitação. Documentação de roteamento e failover

Notas de preço

Cobrado pelo canal que de fato executa o job. O failover pode trocar de canal, o que pode mudar o custo e o tempo.

Usar a API

Deixe o código com um agente, gere direto no chat com MCP ou a Skill, ou integre você mesmo com o SDK ou a API compatível com OpenAI.

Deixe um agente de código fazer a integração

Copie o prompt de integração ou abra direto no Codex ou no Claude. O agente lê esta página e o contrato do modelo e depois escreve o envio, a espera e o tratamento do resultado no seu projeto.

Adicione o servidor MCP da Yir

Conecte ao ChatGPT, Claude ou Cursor, mencione @Yir e peça o Kling 3.0 Omni pelo nome. Ele mostra o preço primeiro e só gera depois que você confirmar.

https://gateway.yir.ai/mcp
Passos para cada cliente

Um comando para o Claude Code

Crie uma API key no console, defina como YIR_API_KEY e execute:

claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"

Instale a Yir Skill

Defina YIR_API_KEY onde seu agente roda, adicione a Skill ao Claude Code, Codex ou outro agente de código e diga “use o Kling 3.0 Omni na Yir para criar…”.

npx skills add yir-ai/skills
Sobre a Yir Skill

Instale o SDK oficial com seu gerenciador de pacotes ou copie o snippet abaixo para começar

$pnpm add @yir-ai/sdk
import { createNodeYirClient } from "@yir-ai/sdk/server";
 
// Lê YIR_API_KEY do ambiente por padrão: process.env.YIR_API_KEY
const client = createNodeYirClient();
 
// 1. Envia um job de geração de vídeo
const job = await client.submitVideo({
model: "klingai/kling-3.0-omni",
input: {
type: "text",
prompt: "Uma tartaruga marinha nada devagar sobre um recife de coral. A câmera acompanha suavemente pela lateral enquanto a luz do sol atravessa a água cristalina, projetando padrões em movimento no casco",
},
parameters: {
duration: 5,
resolution: "720p",
aspect_ratio: "16:9",
generate_audio: false,
n: 1,
},
});
 
// 2. Aguarda o job terminar e entregar o resultado
const result = await client.waitForJob(job.id);
console.log("Arquivos entregues:", result.result);
if (result.result && "files" in result.result) {
for (const file of result.result.files) {
console.log("->", file.url);
}
}

Projetos que já usam o protocolo da OpenAI, ou gateways como o new-api, só precisam de uma nova Base URL e key. Guia de compatibilidade com OpenAI

base_url do SDK da OpenAI
https://gateway.yir.ai/openai/v1
Base URL do canal no new-api
https://gateway.yir.ai/openai
Key
API Key do Yir
ID do 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": "Uma tartaruga marinha nada devagar sobre um recife de coral. A câmera acompanha suavemente pela lateral enquanto a luz do sol atravessa a água cristalina, projetando padrões em movimento no casco",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "seconds": "5"
  }'

Visão geral dos parâmetros

Parâmetros comuns; os limites dependem do modelo atual e do canal selecionado

Docs da API
Resolução
resolution
  • 720p
  • 1080p
  • 4K

Faixa de resolução da saída. Resoluções maiores dão mais nitidez e o preço acompanha

Proporção
aspect_ratio
  • 16:9
  • 9:16
  • 1:1

Proporção geométrica. Escolha de acordo com o meio de destino (retrato, banner ou quadrado)

Modo de entrada
input_mode
  • Entrada de texto
  • Entrada de referências
  • Entrada de imagem

Os limites e formatos de referência dependem do modelo e do canal selecionado

Duração
duration
  • 3–15 segundos

Faixa de duração da saída de vídeo, cobrada por segundo ou por faixa

Áudio
generate_audio
  • Opcional

Faixa opcional de áudio nativo sincronizado

Referências
references
  • first_frame ≤ 1
  • last_frame ≤ 1
  • reference_image ≤ 7

Até 7 personagens: dê o mesmo nome de subject a 2–4 imagens e chame-o pelo nome no prompt

Perguntas frequentes

Comece a criar com o Kling 3.0 Omni

Compare a mesma especificação entre canais e chame vários canais com uma única carteira.