logo
RunComfy
  • ComfyUI
  • TreinadorNovo
  • Modelos
  • API
  • Preços
discord logo
MODELOS
Explorar
Todos os modelos
BIBLIOTECA
Gerações
APIS DE MODELOS
Documentação da API
Chaves API
CONTA
Uso

Kling V3.0 4K: geração text-to-video nativa em 4K no Playground e via API | RunComfy

kling/kling-3.0/4k/text-to-video

Gere vídeos cinematográficos nativos em 4K a partir de texto, com diálogos sincronizados, narrativa multi-shot, personagens consistentes e integração via API, tudo por uma tarifa fixa por segundo.

Índice

1. Introdução2. Autenticação3. Referência da APIEnviar uma solicitaçãoStatus da solicitaçãoObter resultadosCancelar solicitação4. Arquivos de entradaArquivo hospedado (URL)5. EsquemaEsquema de entradaEsquema de saída

1. Introdução

Use a API RunComfy para executar kling/kling-3.0/4k/text-to-video. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Native-4K cinematic multi-shot of a Brooklyn artisan coffee shop on a rainy autumn morning. Wide establishing shot through a fogged-up window: a bearded American barista in a denim apron stands behind a polished copper espresso machine, brass fixtures glowing under warm Edison bulbs, exposed brick and hanging plants in the background. Cut to an extreme macro close-up of milk being steamed, micro-foam swirling with visible bubbles and droplets. Cut to a top-down macro shot of his hands pouring a perfect rosetta latte art into a matte ceramic cup, golden crema rippling in slow motion. Cut to a young woman in a cream cable-knit sweater receiving the cup, soft window light catching freckles on her cheeks, green eyes warming as she smiles. Final shot: a slow dolly-out reveals the cozy industrial interior — vinyl records spinning, a chalkboard menu, raindrops streaking the window. Sound of espresso machine hissing, gentle rain on glass, soft indie acoustic guitar. Hyper-detailed textures: yarn weave, hair strands, crema bubbles, raindrop refraction — shot on RED Komodo 6K, anamorphic lenses, shallow depth of field, Kodak Portra color science."
  }'

2. Autenticação

Defina a variável de ambiente YOUR_API_TOKEN com sua chave de API (gerenciamento no Perfil) e inclua em cada solicitação um token Bearer no cabeçalho Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Referência da API

Enviar uma solicitação

Envie um trabalho de geração assíncrono e receba imediatamente um request_id e URLs para status, resultados e cancelamento.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Native-4K cinematic multi-shot of a Brooklyn artisan coffee shop on a rainy autumn morning. Wide establishing shot through a fogged-up window: a bearded American barista in a denim apron stands behind a polished copper espresso machine, brass fixtures glowing under warm Edison bulbs, exposed brick and hanging plants in the background. Cut to an extreme macro close-up of milk being steamed, micro-foam swirling with visible bubbles and droplets. Cut to a top-down macro shot of his hands pouring a perfect rosetta latte art into a matte ceramic cup, golden crema rippling in slow motion. Cut to a young woman in a cream cable-knit sweater receiving the cup, soft window light catching freckles on her cheeks, green eyes warming as she smiles. Final shot: a slow dolly-out reveals the cozy industrial interior — vinyl records spinning, a chalkboard menu, raindrops streaking the window. Sound of espresso machine hissing, gentle rain on glass, soft indie acoustic guitar. Hyper-detailed textures: yarn weave, hair strands, crema bubbles, raindrop refraction — shot on RED Komodo 6K, anamorphic lenses, shallow depth of field, Kodak Portra color science."
  }'

Status da solicitação

Obtém o estado atual de um request_id ("in_queue", "in_progress", "completed" ou "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Obter resultados

Obtém as saídas finais e metadados do request_id; se o trabalho não estiver concluído, a resposta retorna o estado atual para continuar o polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Cancelar solicitação

Cancela um trabalho na fila por request_id; trabalhos em andamento não podem ser cancelados.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Arquivos de entrada

Arquivo hospedado (URL)

Forneça uma URL HTTPS publicamente acessível. O host deve permitir buscas no servidor (sem login/cookies), sem limite de taxa agressivo ou bloqueio de bots. Recomendado: imagens ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min em 720p). Para ativos privados, URLs estáveis ou pré-assinadas.

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Descrição de texto da cena, movimento, estilo da câmera e atmosfera.",
      "type": "string",
      "default": "Native-4K cinematic multi-shot of a Brooklyn artisan coffee shop on a rainy autumn morning. Wide establishing shot through a fogged-up window: a bearded American barista in a denim apron stands behind a polished copper espresso machine, brass fixtures glowing under warm Edison bulbs, exposed brick and hanging plants in the background. Cut to an extreme macro close-up of milk being steamed, micro-foam swirling with visible bubbles and droplets. Cut to a top-down macro shot of his hands pouring a perfect rosetta latte art into a matte ceramic cup, golden crema rippling in slow motion. Cut to a young woman in a cream cable-knit sweater receiving the cup, soft window light catching freckles on her cheeks, green eyes warming as she smiles. Final shot: a slow dolly-out reveals the cozy industrial interior — vinyl records spinning, a chalkboard menu, raindrops streaking the window. Sound of espresso machine hissing, gentle rain on glass, soft indie acoustic guitar. Hyper-detailed textures: yarn weave, hair strands, crema bubbles, raindrop refraction — shot on RED Komodo 6K, anamorphic lenses, shallow depth of field, Kodak Portra color science."
    },
    "negative_prompt": {
      "title": "Prompt negativo",
      "description": "Elementos a serem excluídos do vídeo.",
      "type": "string"
    },
    "duration": {
      "title": "Duração",
      "description": "Duração do vídeo em segundos.",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 5
    },
    "aspect_ratio": {
      "title": "Proporção (L:A)",
      "description": "Proporção de saída do vídeo gerado.",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "cfg_scale": {
      "title": "Escala de orientação",
      "description": "Força de orientação imediata.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0.5
    },
    "sound": {
      "title": "Áudio",
      "description": "Gere som sincronizado junto com o vídeo.",
      "type": "boolean",
      "default": true
    },
    "multi_prompt": {
      "title": "Segmentos de múltiplos prompts",
      "description": "Segmentos de prompt adicionais para orientar transições e progressões de cena. A soma das durações em multi_prompt deve ser igual à duração total do vídeo",
      "type": "array",
      "items": {
        "prompt": {
          "title": "Prompt",
          "description": "Segmentos de prompt adicionais para orientar transições e progressões de cena.",
          "type": "string",
          "format": "str"
        },
        "duration": {
          "title": "Duração",
          "description": "Duração do segmento de prompt em segundos.",
          "type": "integer",
          "format": "int_slider_with_range",
          "minimum": 3,
          "maximum": 15,
          "default": 5
        }
      },
      "maxItems": 20,
      "minItems": 0
    },
    "shot_type": {
      "title": "Tipo de plano",
      "description": "Modo de edição: inteligente (padrão, escopo autodeterminado) ou personalizado.",
      "type": "string",
      "enum": [
        "customize"
      ],
      "default": "customize"
    }
  }
}

Esquema de saída

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de imagem única"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de vídeo único"
      },
      "images": {
        "type": "array",
        "description": "várias URLs de imagem",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "várias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Siga-nos
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Suporte
  • Discord
  • E-mail
  • Status do Sistema
  • afiliado
Modelos de Vídeo
  • MiniMax H3
  • Minimax H3 Image to Video
  • FLUX 3 Video
  • Happy Horse 1.1 reference to video
  • Wan 2.6 Flash
  • Hailuo 2.3 Fast Standard
  • Ver todos os modelos →
Modelos de Imagem
  • FLUX 3 Image
  • Seedream 5.0 Pro Image Edit
  • Flux 2 Flash Edit
  • seedream 4.0
  • GPT Image 2 Image Edit
  • Nano Banana Pro
  • Ver todos os modelos →
Legal
  • Termos de Serviço
  • Política de Privacidade
  • Política de Cookies
RunComfy
Copyright 2026 RunComfy. Todos os Direitos Reservados.

RunComfy é a principal ComfyUI plataforma, oferecendo ComfyUI online ambiente e serviços, juntamente com fluxos de trabalho do ComfyUI apresentando visuais impressionantes. RunComfy também oferece AI Models, permitindo que artistas utilizem as mais recentes ferramentas de AI para criar arte incrível.