# Kling 3.0 Omni

> 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

- Página do modelo: https://yir.ai/pt/models/kling-3-omni
- ID do modelo: `klingai/kling-3.0-omni`
- Cobrança: pelo canal que executou o job; tentativas que o upstream não cobrou são grátis.

## Preços

Preços públicos atuais por canal para a mesma especificação de saída; os preços oficiais são uma referência. Você paga pelo canal que de fato executa o job, que pode mudar em um failover.

| Especificação de saída | Canal | Preço público |
|---|---|---|
| 720p · sem áudio | Kling AI (oficial) | $ 0,084 / segundo |
| 720p · sem áudio | APIMart | $ 0,0672 / segundo |
| 720p · sem áudio | KIE | $ 0,0755 / segundo |
| 720p · sem áudio | FAL | $ 0,084 / segundo |
| 720p · com áudio | Kling AI (oficial) | $ 0,112 / segundo |
| 720p · com áudio | APIMart | $ 0,0896 / segundo |
| 720p · com áudio | KIE | $ 0,101 / segundo |
| 720p · com áudio | FAL | $ 0,112 / segundo |
| 1080p · sem áudio | Kling AI (oficial) | $ 0,112 / segundo |
| 1080p · sem áudio | APIMart | $ 0,0896 / segundo |
| 1080p · sem áudio | KIE | $ 0,101 / segundo |
| 1080p · sem áudio | FAL · pro | $ 0,112 / segundo |
| 1080p · com áudio | Kling AI (oficial) | $ 0,14 / segundo |
| 1080p · com áudio | APIMart | $ 0,112 / segundo |
| 1080p · com áudio | KIE | $ 0,126 / segundo |
| 1080p · com áudio | FAL · pro | $ 0,14 / segundo |
| 4K | Kling AI (oficial) | $ 0,42 / segundo |
| 4K | KIE | $ 0,3775 / segundo |
| 4K | FAL · native4k | $ 0,42 / segundo |
| 4K | APIMart | $ 0,4286 / segundo |

## Parâmetros

- Operação: `generate_video`

| Parâmetro | Valores | Padrão |
|---|---|---|
| `input` | text / reference / image | text |
| `resolution` | 720p / 1080p / 4K | 720p |
| `aspect_ratio` | 16:9 / 9:16 / 1:1 | 16:9 |
| `duration` | 3 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 | 5 |
| `generate_audio` | true / false | false |

## Integração

Escolha uma opção: o SDK oficial para código novo, ou troque a Base URL em projetos que já usam o protocolo da OpenAI.

### SDK oficial (TypeScript)

O SDK chama a Standard API (https://gateway.yir.ai) para enviar, aguardar e coletar jobs; também há um SDK em Go. https://yir.ai/docs/integrations/sdk

```bash
pnpm add @yir-ai/sdk
```

```ts
import { createNodeYirClient } from "@yir-ai/sdk/server";

// Reads YIR_API_KEY from the environment by default: process.env.YIR_API_KEY
const client = createNodeYirClient();

// 1. Submit a video generation job
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. Wait for the job to finish and deliver its result
const result = await client.waitForJob(job.id);
console.log("Delivered files:", result.result);
if (result.result && "files" in result.result) {
  for (const file of result.result.files) {
    console.log("->", file.url);
  }
}
```

### API compatível com OpenAI

Protocolos OpenAI Images e Sora Videos para SDKs da OpenAI e gateways como o new-api; sem chat. https://yir.ai/docs/integrations/openai-compatibility

- base_url do SDK da OpenAI: `https://gateway.yir.ai/openai/v1`
- Base URL do canal no new-api (tipo de canal OpenAI): `https://gateway.yir.ai/openai`
- ID do modelo: `klingai/kling-3.0-omni`

```bash
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"
  }'
```

## FAQ

### Kling 3.0 Omni tem uma API oficial?

Sim. Kling AI vende Kling 3.0 Omni pela própria API oficial. Na mesma especificação, os provedores terceiros na Yir cobram até 20% menos (veja a tabela acima), e você chama todos com uma única chave de API da Yir.

## Regras

- Autentique com Authorization: Bearer $YIR_API_KEY; mantenha a key em uma variável de ambiente do servidor, nunca em código de navegador, controle de versão, prompts ou logs.
- Os jobs são assíncronos: guarde o Job ID, espere um estado final e depois leia o resultado; trate falhas e cancelamentos.
- Para retentativas seguras, reutilize a mesma chave de idempotência e a mesma requisição; não reenvie às cegas quando o resultado for desconhecido.
- As URLs de resultado são temporárias; copie os arquivos para outro lugar se precisar guardá-los.

## Links

- [Início rápido](https://yir.ai/docs/getting-started/quickstart)
- [Referência da API](https://yir.ai/docs/reference)
- [llms.txt](https://yir.ai/llms.txt)
