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

Fantasy Portrait: Animação de Retrato com Movimento Expressivo | Imagem para Vídeo

community/fantasy-portrait/image-to-video

Fantasy Portrait transforma uma única imagem de retrato e um vídeo de referência em animações cinematográficas em MP4, utilizando o FantasyPortrait (Fantasy-AMAP) com o WanVideo 2.1 para movimentos expressivos que preservam a identidade.

Í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 community/fantasy-portrait/image-to-video. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/community/fantasy-portrait/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "143_image": "Runcomfy_example_1268_1.png",
    "160_video": "Runcomfy_example_1268_1.mp4",
    "155_positive_prompt": "woman acting"
  }'

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/community/fantasy-portrait/image-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "143_image": "Runcomfy_example_1268_1.png",
    "160_video": "Runcomfy_example_1268_1.mp4",
    "155_positive_prompt": "woman acting"
  }'

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": [
    "143_image",
    "160_video",
    "155_positive_prompt"
  ],
  "properties": {
    "160_video": {
      "title": "Video",
      "description": "",
      "type": "string",
      "default": "Runcomfy_example_1268_1.mp4"
    },
    "143_image": {
      "title": "Image",
      "description": "",
      "type": "string",
      "default": "Runcomfy_example_1268_1.png"
    },
    "155_positive_prompt": {
      "title": "Prompt",
      "description": "",
      "type": "string",
      "default": "woman acting"
    },
    "169_valuex170_value": {
      "title": "Resolution (W:H)",
      "description": "",
      "type": "string",
      "enum": [
        "480x480 (1:1)",
        "720x720 (1:1)",
        "480x720 (2:3)",
        "720x480 (3:2)",
        "540x960 (9:16)",
        "576x1024 (9:16)",
        "720x1280 (9:16)",
        "960x540 (16:9)",
        "1024x576 (16:9)",
        "1280x720 (16:9)"
      ],
      "default": "720x720 (1:1)"
    },
    "174_value": {
      "title": "Number of Frames",
      "description": "",
      "type": "integer",
      "enum": [
        81,
        141
      ],
      "default": 81
    },
    "163_frame_rate": {
      "title": "Frames Per Second",
      "description": "",
      "type": "integer",
      "default": 16,
      "minimum": 12,
      "maximum": 24
    },
    "150_strength": {
      "title": "Strength",
      "description": "Controls how strongly the Fantasy Portrait embedding influences the video generation, higher emphasizes the portrait and expressions.",
      "type": "float",
      "default": 1,
      "minimum": 0.3,
      "maximum": 2
    },
    "149_seed": {
      "title": "Seed",
      "description": "",
      "type": "integer",
      "default": 96860978
    },
    "149_steps": {
      "title": "Steps",
      "description": "Number of denoising iterations; more steps refine detail and stability but take longer.",
      "type": "integer",
      "default": 6,
      "minimum": 6,
      "maximum": 20
    },
    "149_cfg": {
      "title": "Guidance Scale",
      "description": "Controls how strongly the output adheres to the prompt versus allowing creative variation.",
      "type": "float",
      "default": 1,
      "minimum": 0.6,
      "maximum": 2
    },
    "149_shift": {
      "title": "Shift",
      "description": "Offsets the diffusion sampling schedule, trading stability for stronger motion/style as the value increases.",
      "type": "integer",
      "default": 5,
      "minimum": 1,
      "maximum": 15
    }
  }
}

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
  • Wan 2.6 Flash
  • Kling Video O3 Pro Image To Video
  • Wan 2.6
  • Seedance 2.0 Fast
  • Hailuo 2.3 Fast Standard
  • Kling 3.0
  • Ver todos os modelos →
Modelos de Imagem
  • seedream 4.0
  • Nano Banana 2 Edit
  • Flux 2 Dev
  • Nano Banana Pro
  • GPT Image 2 Image Edit
  • FLUX.1 Schnell
  • 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.