Source: https://ailoot.ai/models/pt-pt/kwaivgi-kling-v3-0-pro/
Canonical: https://ailoot.ai/models/pt-pt/kwaivgi-kling-v3-0-pro/
Language: pt-pt

# Kling: Video v3.0 Pro

[Markdown](https://ailoot.ai/models/pt-pt/kwaivgi-kling-v3-0-pro/index.md) · [JSON](https://ailoot.ai/models/pt-pt/kwaivgi-kling-v3-0-pro/facts.json)

## [Kling: Video v3.0 Pro](https://ailoot.ai/models/pt-pt/kwaivgi-kling-v3-0-pro/)

Kling VIDEO 3.0 Pro é o perfil profissional de vídeo a 1080p da Kuaishou para cenas orientadas por texto e imagem. Combina clipes de três a quinze segundos, áudio nativo, fotogramas de início e fim guiados e direção num único plano ou em vários planos para conceitos cinematográficos e produções curtas.

- [**Ailoot Ultra · Vídeo** `POST /v1/videos` `kwaivgi/kling-v3.0-pro`](https://ailoot.ai/models/pt-pt/kwaivgi-kling-v3-0-pro/#method-0)

Sobre o modelo

Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.

Kling VIDEO 3.0 Pro é o perfil profissional do modelo VIDEO 3.0 da Kuaishou. O seu modo Pro documentado produz vídeo a 1080p a partir de instruções em texto ou de uma cena orientada por imagem, com clipes de três a quinze segundos. A edição 3.0 combina áudio nativo, controlos de consistência dos sujeitos e direção de vários planos, dando a uma produção curta uma forma clara de especificar o aspeto, a ação, a cobertura da câmara e o som.

Comece pela ação principal da cena. Num plano orientado por texto, descreva o sujeito, o ambiente, a luz e o ponto de vista que torna a ação compreensível. Num plano orientado por imagem, deixe que a imagem inicial estabeleça o aspeto e a composição e utilize depois o texto para indicar o que muda ao longo do tempo. Num conceito original de produto, uma imagem preparada pode mostrar o objeto numa superfície de estúdio enquanto a instrução descreve uma revelação lenta do seu material e da sua forma.

A direção de vários planos oferece cobertura automática ou uma sequência personalizada. A geração automática de vários planos planeia mudanças de enquadramento e de ângulo da câmara a partir das instruções; uma cena que caiba numa vista contínua pode ainda manter-se num único plano. Um storyboard personalizado permite definir o conteúdo e a duração de cada plano. O perfil de planos personalizados do produtor permite entre um e seis planos, com um máximo de 512 caracteres por plano e um mínimo de um segundo para cada um; as suas durações têm de perfazer a duração total do clipe.

Numa narrativa curta, descreva uma vista de apresentação, a ação principal e um pormenor final como planos separados. Indique o tratamento da câmara e aquilo em que o público deve reparar em cada um. Mantenha consistente nas instruções o aspeto de um sujeito recorrente, alterando deliberadamente a ação e a cobertura. O campo de instrução única na referência do fabricante aceita até 2 500 caracteres; uma sequência personalizada utiliza as suas descrições separadas por plano.

As referências de sujeitos podem apoiar uma cena orientada por imagem quando a personagem, o produto ou o cenário devem manter-se reconhecíveis. Escolha vistas claras que comuniquem as características que precisa de conservar e nomeie cada sujeito de referência de forma consistente. O perfil documentado orientado por imagem permite até três elementos preparados. Mantenha os papéis das referências bem focados, em vez de combinar vários recursos que dão instruções contraditórias sobre o aspeto do sujeito.

Os fotogramas inicial e final fornecem limites visuais para uma transição condicionada por imagem. Prepare fotogramas coerentes quanto ao sujeito e à cena pretendida e descreva depois como o movimento os liga. A entrada de fotogramas suportada pelo fabricante utiliza imagens JPG, JPEG ou PNG, com ficheiros até 10 MB, dimensões de pelo menos 300 píxeis e uma proporção da imagem inicial entre 1:2.5 e 2.5:1. Uma tarefa controlada por fotogramas e um storyboard personalizado têm formas próprias de tratar as entradas, pelo que deve organizar o material para o fluxo de trabalho selecionado antes de escrever as instruções completas.

O áudio nativo pode combinar falas, atmosfera e a interpretação visual. O áudio está desativado por predefinição na referência do fabricante e é ativado para uma cena audiovisual. O perfil linguístico da versão 3.0 inclui chinês, inglês, japonês, coreano e espanhol, juntamente com alternância entre idiomas e os tratamentos de dialeto ou sotaque suportados. O guia do fabricante indica que o diálogo introduzido noutro idioma é traduzido para inglês. Atribua cada fala ao sujeito pretendido e distinga o diálogo do som de fundo, para que as instruções de áudio expliquem quem fala e o que envolve a ação.

Uma instrução original para duas personagens pode identificar o Interlocutor A e o Interlocutor B, dar uma fala curta a cada um e descrever a resposta visível entre ambos. Mantenha o diálogo proporcional à duração do clipe e identifique quem fala quando o ponto de vista muda. A direção de voz e uma referência de personagem servem propósitos diferentes; as instruções devem indicar a interpretação pretendida, em vez de presumir que uma imagem de referência contém as palavras a dizer.

VIDEO 3.0 melhora também o tratamento do texto visível numa cena orientada por imagem. Se um sinal, um rótulo ou uma legenda forem importantes, identifique-os nas instruções e preserve o seu aspeto de referência. Reveja a ortografia, a legibilidade e o movimento desse texto no clipe concluído, sobretudo quando transmite uma mensagem de produto ou de campanha. A funcionalidade de texto do modelo orienta a geração sem substituir uma verificação visual final.

O perfil Pro é a 1080p; o perfil Standard é a 720p. O modo 4K do produtor, selecionado separadamente, é outro perfil de saída, pelo que Pro não deve ser tratado como sinónimo de todas as definições de resolução superior. Para geração orientada por texto, as opções documentadas de enquadramento incluem 16:9, 9:16 e 1:1. Escolha o enquadramento para o local de utilização pretendido e mantenha a composição legível dentro dele.

A geração decorre como uma tarefa cujo resultado bem-sucedido disponibiliza o ficheiro de vídeo concluído e a duração real. A documentação de resultados do fabricante indica que os vídeos gerados são eliminados após 30 dias, pelo que deve guardar o clipe concluído prontamente. Preserve o vídeo com as suas instruções e os recursos de referência e reveja depois a continuidade dos sujeitos, a ordem dos planos pedida, o movimento da câmara, o diálogo e o texto. Utilize o clipe selecionado como conceito cinematográfico, cena de produto ou narrativa curta e faça uma revisão focada na parte que não correspondeu ao resultado pretendido.

**Ailoot Ultra · Vídeo** `POST /v1/videos` `kwaivgi/kling-v3.0-pro`

[`kwaivgi/kling-v3.0-pro`](https://ailoot.ai/models/pt-pt/#m=kwaivgi%2Fkling-v3.0-pro&route=Ultra&caller=kwaivgi%2Fkling-v3.0-pro&fmt=videos)

Kuaishou /`kwaivgi/kling-v3.0-pro`

### Introdução

Kling VIDEO 3.0 Pro é o perfil profissional de vídeo a 1080p da Kuaishou para cenas orientadas por texto e imagem. Combina clipes de três a quinze segundos, áudio nativo, fotogramas de início e fim guiados e direção num único plano ou em vários planos para conceitos cinematográficos e produções curtas.

Entradas aceites

Texto · Imagens

Resultados

Vídeo

### Disponível no Ailoot · entradas e métodos

**Ailoot Ultra · Vídeo** `POST /v1/videos`

Entrada

`text`, `image`

Saída

`video`

Formato de saída

bytes MP4 originais; sem normalização nem transcodificação

| Campo | Tipo | Requisito | Valores e limites | Predefinição |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites kwaivgi/kling-v3.0-pro | Predefinição— |
| Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites | Predefinição— |
| Campo`duration` | Tipo`integer` | RequisitoObrigatório | Valores e limites 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mínimo: 1 Máximo: 600 | Predefinição— |
| Campo`resolution` | Tipo`string` | RequisitoOpcional | Valores e limites 720p | Predefinição— |
| Campo`aspect_ratio` | Tipo`string` | RequisitoOpcional | Valores e limites 16:9, 9:16, 1:1 | Predefinição— |
| Campo`generate_audio` | Tipo`boolean` | RequisitoOpcional | Valores e limites false, true Condições: Omitir esta opção seleciona o preço com áudio. Defina-a como false para selecionar o preço sem áudio. Verifique has\_audio no resultado para saber se foi devolvida uma faixa de áudio. | Predefinição— |
| Campo`frame_images` | Tipo`array` | RequisitoOpcional | Valores e limites Número mínimo de elementos: 1 Número máximo de elementos: 2 Conteúdo de entrada: Matriz de objetos de fotograma. Cada objeto tem type=image\_url, image\_url com url e frame\_type. Utilize um URL HTTPS de imagem e defina frame\_type como first\_frame ou last\_frame. Cada função de fotograma aparece, no máximo, uma vez. Chaves exatas: type, image\_url, frame\_type Condições: Estas chaves descrevem cada objeto de fotograma; image\_url contém apenas url. Omita frame\_images num pedido apenas de texto. | Predefinição— |
| Campo`input_references` | Tipo`array` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`size` | Tipo`string` | RequisitoOpcional | Valores e limites 1280x720, 720x1280, 720x720 Padrão: ^\[1-9\]\[0-9\]\*x\[1-9\]\[0-9\]\*$ | Predefinição— |
| Campo`callback_url` | Tipo`string` | RequisitoOpcional | Valores e limites Padrão: ^https:// | Predefinição— |
| Campo`session_id` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`trace` | Tipo`object` | RequisitoOpcional | Valores e limites | Predefinição— |
| Campo`user` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— |

Combinações de materiais de entrada

**Texto para vídeo** · Uma instrução escrita. · Obrigatório: model, prompt, duration

`Forneça prompt como texto e duration em segundos inteiros. Escolha uma resolução suportada; adicione uma proporção ou utilize um tamanho enumerado.`

`model`: Tipo: string · kwaivgi/kling-v3.0-pro

`prompt`: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim

**Imagem para vídeo** · Uma instrução escrita e uma imagem do primeiro fotograma. · Obrigatório: model, prompt, duration, frame\_images

`frame_images é uma matriz. Cada objeto de fotograma tem type, image_url e frame_type; image_url contém url. Defina type como image_url. Utilize first_frame com um last_frame opcional. Cada função de fotograma aparece, no máximo, uma vez. Forneça um URL HTTPS público de imagem para cada fotograma. Escolha uma resolução suportada; adicione uma proporção ou utilize um tamanho enumerado.`

Chaves exatas: type, image\_url, frame\_type

`model`: Tipo: string · kwaivgi/kling-v3.0-pro

`prompt`: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim

Parâmetros e ciclo de vida do método

| Parâmetro | Contrato |
| --- | --- |
| Parâmetro`content_type` | Contratoapplication/json |
| Parâmetro`required` | Contratomodel, prompt, duration |
| Parâmetro`material_types` | Contratotext, image |
| Parâmetro`additional_properties` | Contratofalse |
| Parâmetro`optional_controls` | Contratoresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, size, callback\_url, session\_id, trace, user |

Ciclo de vida: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_id}/content`

### Tarifários

##### Cálculo do custo final

As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.

As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.

Modo rápido

Não especificado Quando o modo rápido está selecionado

Modo flex

Não especificado Quando o modo flex está selecionado

Esforço máximo de raciocínio

Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)

#### Tarifas estimadas para comparação

#### Preços por configuração

Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.

| Configuração | Tabela de tarifas | Quantidade prevista | Componente do custo | Resolução de referência | Modo de referência | Áudio de referência | Unidade de faturação | Condições de faturação | Custo |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Componente do custo— | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturação— | Condições de faturação— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação **—** / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação **—** / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação **—** / 1K tokens |
| ConfiguraçãoSaída de vídeo · tarifa de referência | Tabela de tarifas— | Quantidade prevista— | Componente do custo`reference_output_rate` | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturaçãopor segundo de saída | Condições de faturação— | Custo Saída · Tarifa de referência por segundo de vídeo de saída · Estimativa apenas para comparação **$0.224** por segundo de saída |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Componente do custo— | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoáudio: with\_audio | Custo Saída · Preço do vídeo · Estimativa apenas para comparação **$0.336** por segundo de vídeo |
| ConfiguraçãoImagem para vídeo (imagens de fotogramas) · 1080p · tarifa de referência | Tabela de tarifas— | Quantidade prevista— | Componente do custo`reference_output_rate` | Resolução de referência1080p | Modo de referênciaImagem para vídeo (fotogramas) | Áudio de referênciaSem áudio | Unidade de faturaçãopor segundo de saída | Condições de faturação— | Custo Saída · Tarifa de referência por segundo de vídeo de saída · Estimativa apenas para comparação **$0.224** por segundo de saída |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Componente do custo— | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãomodo de geração: image\_to\_video; resolução: 720p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação **$0.224** por segundo de vídeo |
| ConfiguraçãoTexto para vídeo · 1080p · tarifa de referência | Tabela de tarifas— | Quantidade prevista— | Componente do custo`reference_output_rate` | Resolução de referência1080p | Modo de referênciaTexto para vídeo | Áudio de referênciaSem áudio | Unidade de faturaçãopor segundo de saída | Condições de faturação— | Custo Saída · Tarifa de referência por segundo de vídeo de saída · Estimativa apenas para comparação **$0.224** por segundo de saída |
| ConfiguraçãoTexto para vídeo · 480p · tarifa de referência | Tabela de tarifas— | Quantidade prevista— | Componente do custo`reference_output_rate` | Resolução de referência480p | Modo de referênciaTexto para vídeo | Áudio de referênciaSem áudio | Unidade de faturaçãopor segundo de saída | Condições de faturação— | Custo Saída · Tarifa de referência por segundo de vídeo de saída · Estimativa apenas para comparação **$0.224** por segundo de saída |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Componente do custo— | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãomodo de geração: text\_to\_video; resolução: 720p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação **$0.224** por segundo de vídeo |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Componente do custo— | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturação— | Condições de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação **$0.672** estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída. |

O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. [Como funcionam a reserva e a liquidação →](https://ailoot.ai/docs/pt-pt/billing/reserve/)

#### Detalhes da tarifa de referência

As tabelas de referência do modelo não alteram a seleção do método, as cotações ou os custos. Os custos ativos usam as tarifas do método Ailoot selecionado.

Referências de preços das configurações de vídeo

#### Preços por configuração

Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.

| Configuração | Condições de faturação | Custo |
| --- | --- | --- |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãoNão é declarada nenhuma condição adicional nesta chave de preços. | Custo Saída · Preço do vídeo **$0.224** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãoáudio: with\_audio | Custo Saída · Preço do vídeo **$0.336** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: text\_to\_video; resolução: 480p | Custo Saída · Preço do vídeo **$0.224** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: text\_to\_video; resolução: 720p | Custo Saída · Preço do vídeo **$0.224** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: image\_to\_video; resolução: 720p | Custo Saída · Preço do vídeo **$0.224** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: text\_to\_video; resolução: 1080p | Custo Saída · Preço do vídeo **$0.224** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: image\_to\_video; resolução: 1080p | Custo Saída · Preço do vídeo **$0.224** por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |

### Exemplos de pedidos

#### Ailoot Ultra · Vídeo

curl · crie um vídeo

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"kwaivgi/kling-v3.0-pro","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### Receber e guardar os resultados

#### Ailoot Ultra · Vídeo

URLs assinados para conteúdo pertencente ao utilizador

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Verificar o estado da tarefa

GET estado da operação original

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

Outras leituras de conteúdo

Guardar cada saída concluída de que é titular

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### Guardar todos os resultados concluídos

Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.

Conserve todos os resultados reais que pertencem ao utilizador e os respetivos metadados medidos devolvidos.

##### Se for necessário verificar a resposta original

503 result\_pending\_check + id original + X-Should-Retry:false; nunca repita o original

Campos da resposta

| Campo | Tipo | Significado |
| --- | --- | --- |
| Campo`index` | Tipointeger | SignificadoPosição deste vídeo na lista de saídas, com contagem a partir de zero. |
| Campo`content_url` | Tipostring | SignificadoURL HTTPS assinado para transferir este vídeo concluído. |
| Campo`sha256` | Tipostring \| null | SignificadoResumo criptográfico SHA-256 dos bytes do vídeo original; null se não estiver disponível. |
| Campo`size_bytes` | Tipointeger \| null | SignificadoTamanho do ficheiro de vídeo original em bytes; null se não estiver disponível. |
| Campo`duration_ms` | Tipointeger \| null | SignificadoDuração medida do vídeo em milissegundos; null se não estiver disponível. |
| Campo`width` | Tipointeger \| null | SignificadoLargura do vídeo em píxeis; null se não estiver disponível. |
| Campo`height` | Tipointeger \| null | SignificadoAltura do vídeo em píxeis; null se não estiver disponível. |
| Campo`video_codec` | Tipostring \| null | SignificadoIdentificador do codec de vídeo; null se não estiver registado. |
| Campo`has_audio` | Tipoboolean \| null | SignificadoIndica se o vídeo contém uma faixa de áudio; null se não tiver sido medido. |
| Campo`audio_codec` | Tipostring \| null | SignificadoIdentificador do codec de áudio; null quando não está registado qualquer identificador. |

Erros e passos seguintes

| Resposta | Condição | Passo seguinte |
| --- | --- | --- |
| Resposta404 · `not_found_error` | CondiçãoO acesso ao vídeo não está disponível ou este ID de vídeo não foi encontrado. | Passo seguinteVerifique o acesso ao vídeo. Para um vídeo existente, utilize o ID público original e a mesma chave API. |
| Resposta401 · `authentication_error` | CondiçãoA chave API não corresponde à conta autenticada. | Passo seguinteVerifique a sua chave API e o acesso à conta antes de enviar. |
| Resposta400 · `invalid_request_error` | CondiçãoNão foi possível ler o pedido ou o índice de transferência é inválido. | Passo seguinteCorrija o corpo do pedido. Para uma transferência, escolha um índice de saída devolvido pela tarefa original. |
| Resposta422 · `price_unavailable` | CondiçãoNão é possível calcular o preço da configuração de vídeo selecionada. | Passo seguinteEscolha uma configuração de vídeo suportada e preencha as opções obrigatórias antes de enviar um pedido corrigido. |
| Resposta422 · `invalid_request_error` | CondiçãoUma entrada de vídeo ou a tarefa original de continuação é inválida. | Passo seguinteUtilize entradas HTTPS válidas. Para continuação, utilize o ID público do seu vídeo original concluído com a mesma chave API. |
| Resposta402 · `billing_error` | CondiçãoO saldo disponível ou os limites não permitem efetuar uma reserva. | Passo seguinteVerifique o saldo disponível e os limites antes de enviar um novo pedido. |
| Resposta503 · `server_error` | CondiçãoA verificação, o armazenamento ou o acesso ao serviço de vídeo está temporariamente indisponível. | Passo seguinteAguarde a disponibilidade do serviço. Se já tiver um ID de vídeo, consulte essa tarefa original em vez de criar outra geração. |
| Resposta503 · `result_pending_check` | CondiçãoO resultado e a cobrança do vídeo original precisam de verificação. | Passo seguinteConserve o ID de vídeo devolvido e consulte essa tarefa. Não envie um pedido de geração substituto enquanto estiver a ser verificada. |
| Resposta503 · `owned_result_unavailable` | CondiçãoA transferência do vídeo existente está temporariamente indisponível. | Passo seguinteConsulte a mesma tarefa de vídeo mais tarde e transfira a saída existente. Uma nova geração cria uma operação separada. |
| Resposta409 · `video_not_ready` | CondiçãoO conteúdo do vídeo não foi publicado. | Passo seguinteConsulte o estado da tarefa original. Transfira quando indicar completed; se indicar failed, siga o aviso de verificação da cobrança. |

### Aliases

#### Aliases do modelo

**Ailoot Ultra** [`kwaivgi/kling-v3.0-pro`](https://ailoot.ai/models/pt-pt/#m=kwaivgi%2Fkling-v3.0-pro&route=Ultra&caller=kwaivgi%2Fkling-v3.0-pro&fmt=videos)

#### Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

#### IDs de chamada relacionados

[`kwaivgi/kling-v3.0-pro`](https://ailoot.ai/models/pt-pt/#m=kwaivgi%2Fkling-v3.0-pro&route=Ultra&caller=kwaivgi%2Fkling-v3.0-pro&fmt=videos)

FAQ · Kling: Video v3.0 Pro

Que entradas e resultados estão disponíveis?

`POST /v1/videos` · `kwaivgi/kling-v3.0-pro`: `text`, `image` → `video`

Que campos utiliza o pedido?

`POST /v1/videos` · `kwaivgi/kling-v3.0-pro`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `size`, `callback_url`, `session_id`, `trace`, `user`

Que limites se aplicam?

`POST /v1/videos` · `kwaivgi/kling-v3.0-pro`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`

Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação.

## A empresa e a sua carteira de projetos

A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.

## Compre tokens com desconto.

Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens.

Subscrição

Escolha um plano com desconto para os pedidos regulares.

Código promocional até 50%

Introduza o código na compra. O preço é recalculado conforme a campanha em vigor.

Custos no histórico

O modelo, os tokens e o montante são guardados para cada pedido.

[Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/)

## Ligue a API ao produto que vende.

SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor.

Aplicação comercial

Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço.

Licença de revendedor

Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda.

Documentos no site

A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação.

[Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt)

## Ailoot · A empresa e a sua carteira de projetos





A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.





A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.





A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.