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

Wan 3.0 Prime Reference To Video: Vídeo multimodal rápido sobre modelos e API | RunComfy

wan-ai/wan-3.0-prime/reference-to-video

Wan 3.0 Prime Reference To Video combina um prompt com referências de imagem, vídeo e áudio para criar clipes coerentes com assuntos, movimento e som consistentes em uma camada Wan 3.0 mais rápida.

Í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 wan-ai/wan-3.0-prime/reference-to-video. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/wan-ai/wan-3.0-prime/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Image 1 walks slowly through a sunlit botanical garden, pauses beside a glass pavilion, then turns toward the camera with a relaxed smile; soft dappled light, gentle handheld motion, cinematic, quiet ambient birdsong."
  }'

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/wan-ai/wan-3.0-prime/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Image 1 walks slowly through a sunlit botanical garden, pauses beside a glass pavilion, then turns toward the camera with a relaxed smile; soft dappled light, gentle handheld motion, cinematic, quiet ambient birdsong."
  }'

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": "Incitar",
      "description": "Descreva a cena, o assunto, o movimento, o movimento da câmera, a iluminação e o estilo. Consulte as referências como Image 1, Video 1, Audio 1 em ordem.",
      "type": "string",
      "default": "Image 1 walks slowly through a sunlit botanical garden, pauses beside a glass pavilion, then turns toward the camera with a relaxed smile; soft dappled light, gentle handheld motion, cinematic, quiet ambient birdsong."
    },
    "reference_images": {
      "title": "Imagens de referência",
      "description": "Até 10 imagens de referência para consistência de sujeito, objeto ou cena. É necessária pelo menos uma referência (imagem, vídeo ou áudio).",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7431/media-files/input-promo-ref.webp"
      ]
    },
    "reference_videos": {
      "title": "Vídeos de referência",
      "description": "Até 5 vídeos de referência (MP4 ou MOV, 1-15s cada, totalizando não mais que 15s) para orientação de movimento ou cena.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "video_uri"
      },
      "default": []
    },
    "reference_audios": {
      "title": "Áudios de referência",
      "description": "Até 5 clipes de áudio de referência (totalizando não mais que 15s) para orientar o som ou o tempo.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "audio_uri"
      },
      "default": []
    },
    "resolution": {
      "title": "Resolução",
      "description": "Camada de resolução de saída. Use 480p para rascunhos rápidos e 1080p para resultados de maior qualidade.",
      "type": "string",
      "enum": [
        "480p",
        "720p",
        "1080p"
      ],
      "default": "720p"
    },
    "aspect_ratio": {
      "title": "Proporção",
      "description": "Proporção de aspecto de saída do vídeo gerado.",
      "type": "string",
      "enum": [
        "adaptive",
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "Duração (segundos)",
      "description": "Duração do vídeo gerado em segundos. O intervalo é 2-30. Comece curto para iterar e aumente quando o movimento parecer correto.",
      "type": "integer",
      "minimum": 2,
      "maximum": 30,
      "default": 5
    },
    "prompt_extend": {
      "title": "Expansão imediata",
      "description": "Quando ativado, o modelo pode reescrever seu prompt para obter detalhes de cena mais ricos antes da geração. Desative para um retorno mais rápido se sua solicitação já for precisa.",
      "type": "boolean",
      "default": true
    },
    "enable_audio": {
      "title": "Gerar áudio",
      "description": "Quando ativado, o vídeo de saída inclui uma trilha de áudio sincronizada. Desligue para um clipe silencioso.",
      "type": "boolean",
      "default": true
    },
    "seed": {
      "title": "Semente",
      "description": "Semente aleatória para resultados reproduzíveis. O intervalo é de 0 a 2147483647.",
      "type": "integer"
    }
  }
}

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
  • Seedance 2.5 Reference to Video 1080p
  • Seedance 2.5 1080p Text to video
  • Seedance 2.5 1080p
  • MiniMax H3 Open
  • Wan 2.6 Flash
  • Happy Horse 1.1 reference to video
  • Ver todos os modelos →
Modelos de Imagem
  • Qwen Image 3.0 Edit
  • Qwen Image 3.0 Pro Edit
  • Qwen Image 3.0
  • seedream 4.0
  • Flux 2 Flash 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.