Avançar 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"

Ficheiros como o exemplo: 1,175 $ 1175 créditos da API os seus ficheiros 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-30 segundos que mantêm o aspeto de até 10 imagens de referência, 5 vídeos de referência e 7 elementos

Kling · Vídeo

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

88 / 2500

Instruções de geração que cumprem o requisito de fornecer `prompt` ou `multi_prompt`. Para referir entradas fornecidas, use @Image1, @Video1, @Element1 e assim sucessivamente.

video_urls
Largue um ficheiro ou · até 5

Até 5 vídeos de referência, referidos através de @Video1, @Video2 e assim sucessivamente; cada um dura 3–30 segundos (30.05 segundos no máximo), e a duração total, juntamente com os vídeos dos elementos, não pode exceder 30 segundos. Cada ficheiro não pode exceder 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 frames entre 23.9 e 60.05 FPS.

resolution predefinição 1080p

Resolução da saída.

aspect_ratio predefinição 16:9

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

predefinição 5

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

Avançado image · images · multi_prompt · elements
start_image_url
Largue um ficheiro ou

Imagem opcional do primeiro frame que conta para o limite de imagens de referência. O tamanho máximo do ficheiro é 30.0 MB; a largura e a altura devem atingir 300 px cada, com uma proporção entre 0.40 e 2.50.

image_urls
Largue um ficheiro ou · até 10

Imagens de referência referidas através de @Image1, @Image2 e assim sucessivamente, com um máximo de 10 imagens. Cada ficheiro está limitado a 30.0 MB, requer pelo menos 300 px em ambas as dimensões e deve ter uma proporção entre 0.40 e 2.50.

Instruções de geração plano a plano, com cada prompt a definir um plano 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 estes elementos como @Element1, @Element2 e assim sucessivamente.

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 este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre Kling 4.0 Reference to Video

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

Parâmetros

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

NomeTipo PredefiniçãoPermitido Descrição
promptopcional
Tipostring | null
≤ 2500 caracteres
Instruções de geração que cumprem o requisito de fornecer `prompt` ou `multi_prompt`. Para referir entradas fornecidas, use @Image1, @Video1, @Element1 e assim sucessivamente.
multi_promptopcional
Tipoobject[]
Instruções de geração plano a plano, com cada prompt a definir um plano 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 o plano atual.
multi_prompt[].durationopcional
Tipointeger
Predefinição5
1 – 30
Duração de um plano individual, medida em segundos.
durationopcional
Tipointeger
Predefinição5
3 – 30
Duração do vídeo em segundos, de 3 a 30.
start_image_urlopcional image
Tipourl · image
Imagem opcional do primeiro frame que conta para o limite de imagens de referência. O tamanho máximo do ficheiro é 30.0 MB; a largura e a altura devem atingir 300 px cada, com uma proporção entre 0.40 e 2.50.
image_urlsopcional images
Tipourl[] · image
≤ 10 itens
Imagens de referência referidas através de @Image1, @Image2 e assim sucessivamente, com um máximo de 10 imagens. Cada ficheiro está limitado a 30.0 MB, requer pelo menos 300 px em ambas as dimensões e deve ter uma proporção entre 0.40 e 2.50.
video_urlsopcional videos
Tipourl[] · video
≤ 5 itens
Até 5 vídeos de referência, referidos através de @Video1, @Video2 e assim sucessivamente; cada um dura 3–30 segundos (30.05 segundos no máximo), e a duração total, juntamente com os vídeos dos elementos, não pode exceder 30 segundos. Cada ficheiro não pode exceder 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 frames 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 estes elementos como @Element1, @Element2 e assim sucessivamente.
elements[].frontal_image_urlopcional
Tipourl · image
Imagem frontal que mostra a vista principal do elemento. O tamanho máximo do ficheiro é 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 suplementares que mostram ângulos diferentes do elemento, com 1 a 3 vistas. Cada ficheiro pode ter no máximo 30.0 MB, deve medir pelo menos 300 px em ambas as dimensões e ter uma proporção entre 0.40 e 2.50.
elements[].video_urlopcional
Tipourl · video
Representação em vídeo de um elemento em vez de imagens, com duração de 3–30 segundos (30.05 segundos no máximo). O ficheiro não pode exceder 300 MB; a largura e a altura devem estar entre 700–4553 px. As proporções suportadas vão de 0.40–2.50, com taxas de frames de 23.9–60.05 FPS.
elements[].voice_idopcional
Tipostring | null
Voz atribuída ao elemento.
resolutionopcional
Tipoenum
Predefinição1080p
720p1080p
Resolução da saída.
aspect_ratioopcional
Tipoenum
Predefinição16:9
auto16:99:161:121:9
Proporções do vídeo, selecionadas explicitamente ou derivadas das referências ao escolher 'auto'.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

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"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
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á disponível em https://doitong.com/pt-PT/developers/models/kling/v4/reference-to-video.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt