Ir para o conteúdo

Kling 4.0 Reference to Video

Integrar

ID do modelo kling/v4/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/kling/v4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Arquivos como o exemplo: $ 1,175 1.175 créditos de API seus arquivos são medidos antes da execução Executar nesta página

Obter chave de API
Kling Referência para vídeo Entradas de referência3–30 saté 1080p #reference-to-video#multi-shot#image-reference#video-reference

Gera vídeos de 3 a 30 segundos que mantêm a aparência de até 10 imagens de referência, 5 vídeos de referência e 7 elementos

Kling · Vídeo

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

88 / 2500

Instruções de geração que atendem ao requisito de fornecer `prompt` ou `multi_prompt`. Para se referir às entradas fornecidas, use @Image1, @Video1, @Element1 e assim por diante.

video_urls
Solte um arquivo ou · até 5

Até 5 vídeos de referência, referenciados usando @Video1, @Video2 e assim por diante; cada um dura 3–30 segundos (no máximo 30.05 segundos), e a duração total deles junto com os vídeos dos elementos não pode exceder 30 segundos. Cada arquivo deve ter no máximo 300 MB, com largura e altura entre 700 px e 4553 px. A proporção deve estar entre 0.40 e 2.50, e a taxa de quadros entre 23.9 e 60.05 FPS.

resolution padrão 1080p

Resolução da saída.

aspect_ratio padrão 16:9

Proporções do vídeo, selecionadas explicitamente ou derivadas das referências escolhendo 'auto'.

padrão 5

Duração do vídeo em segundos, de 3 a 30.

Avançado image · images · multi_prompt · elements
start_image_url
Solte um arquivo ou

Imagem opcional do primeiro quadro que conta para o limite de imagens de referência. O tamanho máximo do arquivo é 30.0 MB; a largura e a altura devem ter pelo menos 300 px, com proporção entre 0.40 e 2.50.

image_urls
Solte um arquivo ou · até 10

Referências de imagem usadas com @Image1, @Image2 e assim por diante, com no máximo 10 imagens. Cada arquivo é limitado a 30.0 MB, exige pelo menos 300 px em ambas as dimensões e deve ter proporção entre 0.40 e 2.50.

Instruções de geração tomada a tomada, com cada prompt definindo uma tomada cuja duração contribui para a duração total do vídeo.

Coleção de até 7 personagens ou objetos, dos quais no máximo 3 podem incluir um `voice_id` e no máximo 3 podem usar vídeo. Refira-se a esses elementos como @Element1, @Element2 e assim por diante.

POST /run/kling/v4/reference-to-video?wait=20 cotação → $ 1,175
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/kling/v4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre Kling 4.0 Reference to Video

Cria um vídeo a partir de um `prompt` de texto, além de imagens de referência, vídeos de referência e elementos de personagens ou objetos, citados no prompt como @Image1, @Video1 ou @Element1. A duração varia de 3 a 30 segundos (padrão 5), com saída em 720p ou 1080p e proporções auto, 16:9, 9:16, 1:1 ou 21:9. Use `multi_prompt` para prompts por tomada; nesse caso, a duração total é a soma das durações das tomadas. Os limites são 10 imagens, 5 vídeos de 3 a 30s cada e 7 elementos, dos quais até 3 podem ter voz.

Parâmetros

Envie o nome canônico ou o nome nativo, não ambos. Nomes canônicos

NomeTipo PadrãoPermitido Descrição
promptopcional
Tipostring | null
≤ 2.500 caracteres
Instruções de geração que atendem ao requisito de fornecer `prompt` ou `multi_prompt`. Para se referir às entradas fornecidas, use @Image1, @Video1, @Element1 e assim por diante.
multi_promptopcional
Tipoobject[]
Instruções de geração tomada a tomada, com cada prompt definindo uma tomada cuja duração contribui para a duração total do vídeo.
multi_prompt[].promptobrigatório
Tipostring
1 – 512 characters
Instruções de texto para a tomada atual.
multi_prompt[].durationopcional
Tipointeger
Padrão5
1 – 30
Duração de uma tomada individual, medida em segundos.
durationopcional
Tipointeger
Padrão5
3 – 30
Duração do vídeo em segundos, de 3 a 30.
start_image_urlopcional image
Tipourl · image
Imagem opcional do primeiro quadro que conta para o limite de imagens de referência. O tamanho máximo do arquivo é 30.0 MB; a largura e a altura devem ter pelo menos 300 px, com proporção entre 0.40 e 2.50.
image_urlsopcional images
Tipourl[] · image
≤ 10 itens
Referências de imagem usadas com @Image1, @Image2 e assim por diante, com no máximo 10 imagens. Cada arquivo é limitado a 30.0 MB, exige pelo menos 300 px em ambas as dimensões e deve ter proporção entre 0.40 e 2.50.
video_urlsopcional videos
Tipourl[] · video
≤ 5 itens
Até 5 vídeos de referência, referenciados usando @Video1, @Video2 e assim por diante; cada um dura 3–30 segundos (no máximo 30.05 segundos), e a duração total deles junto com os vídeos dos elementos não pode exceder 30 segundos. Cada arquivo deve ter no máximo 300 MB, com largura e altura entre 700 px e 4553 px. A proporção deve estar entre 0.40 e 2.50, e a taxa de quadros entre 23.9 e 60.05 FPS.
elementsopcional
Tipoobject[]
≤ 7 itens
Coleção de até 7 personagens ou objetos, dos quais no máximo 3 podem incluir um `voice_id` e no máximo 3 podem usar vídeo. Refira-se a esses elementos como @Element1, @Element2 e assim por diante.
elements[].frontal_image_urlopcional
Tipourl · image
Imagem frontal que mostra a vista principal do elemento. O tamanho máximo do arquivo é 30.0 MB; ambas as dimensões devem ter pelo menos 300 px, e a proporção deve estar entre 0.40 e 2.50.
elements[].reference_image_urlsopcional
Tipourl[] · image
≤ 3 items
Imagens complementares mostrando ângulos diferentes do elemento, com 1 a 3 vistas. Cada arquivo pode ter no máximo 30.0 MB, deve medir pelo menos 300 px em ambas as dimensões e deve ter proporção entre 0.40 e 2.50.
elements[].video_urlopcional
Tipourl · video
Representação em vídeo de um elemento no lugar de imagens, com duração de 3–30 segundos (no máximo 30.05 segundos). O arquivo não deve exceder 300 MB; a largura e a altura devem estar entre 700–4553 px. As proporções compatíveis variam de 0.40–2.50, com taxas de quadros de 23.9–60.05 FPS.
elements[].voice_idopcional
Tipostring | null
Voz atribuída ao elemento.
resolutionopcional
Tipoenum
Padrão1080p
720p1080p
Resolução da saída.
aspect_ratioopcional
Tipoenum
Padrão16:9
auto16:99:161:121:9
Proporções do vídeo, selecionadas explicitamente ou derivadas das referências escolhendo 'auto'.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "kling/v4/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1175,
    "usd": "1.175",
    "charged": 1175,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
video
object {url, content_type, file_name, file_size}Vídeo produzido pelo modelo.

Mais modelos: Referência para vídeo

Para agentes de IA: esta página em Markdown está em https://doitong.com/pt-BR/developers/models/kling/v4/reference-to-video.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt