API Community Fantasy Portrait | Preços e documentação

community/fantasy-portrait/image-to-video

Anime um retrato a partir de um vídeo e prompt de referência, com resolução selecionável, contagem de quadros, taxa de quadros, controles de amostragem e sementes.

Índice

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": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
    "160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/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": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
    "160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/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": "Vídeo de referência",
      "description": "Vídeo de referência necessário que fornece o movimento a seguir.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4"
    },
    "143_image": {
      "title": "Imagem de retrato",
      "description": "Imagem de retrato necessária do assunto a ser animado.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png"
    },
    "155_positive_prompt": {
      "title": "Prompt",
      "description": "Texto obrigatório que descreve a ação, expressão ou direção visual desejada.",
      "type": "string",
      "default": "woman acting"
    },
    "169_valuex170_value": {
      "title": "Resolução (W:H)",
      "description": "Dimensões de saída. Escolha uma das dez predefinições listadas de quadrado, retrato ou paisagem; padrão: 720x720 (1:1).",
      "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": "Número de quadros",
      "description": "Número de quadros de saída. Escolha 81 ou 141; padrão: 81.",
      "type": "integer",
      "enum": [
        81,
        141
      ],
      "default": 81
    },
    "163_frame_rate": {
      "title": "Quadros por segundo",
      "description": "Taxa de quadros de reprodução de 12 a 24 FPS; padrão: 16.",
      "type": "integer",
      "default": 16,
      "minimum": 12,
      "maximum": 24
    },
    "150_strength": {
      "title": "Força do retrato",
      "description": "Controla a influência da incorporação Fantasy Portrait. Valores mais altos enfatizam o retrato e as expressões; intervalo: 0,3–2,0, padrão: 1.",
      "type": "float",
      "default": 1,
      "minimum": 0.3,
      "maximum": 2
    },
    "149_seed": {
      "title": "Seed",
      "description": "Semente inteira usada para reproduzir ou variar uma geração; padrão: 96860978.",
      "type": "integer",
      "default": 96860978
    },
    "149_steps": {
      "title": "Etapas de amostragem",
      "description": "Iterações de remoção de ruído. Mais etapas podem refinar os detalhes e a estabilidade, mas demoram mais; intervalo: 6–20, padrão: 6.",
      "type": "integer",
      "default": 6,
      "minimum": 6,
      "maximum": 20
    },
    "149_cfg": {
      "title": "Escala de aderência ao prompt",
      "description": "Controla a aderência ao prompt versus variação criativa; intervalo: 0,6–2,0, padrão: 1.",
      "type": "float",
      "default": 1,
      "minimum": 0.6,
      "maximum": 2
    },
    "149_shift": {
      "title": "Deslocamento de amostragem",
      "description": "Compensa o cronograma de amostragem. Valores mais altos favorecem movimentos ou estilos mais fortes em vez de estabilidade; intervalo: 1–15, padrão: 5.",
      "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"
        }
      }
    }
  }
}

RunComfy

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.

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": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
    "160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4",
    "155_positive_prompt": "woman acting"
  }'

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": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png",
    "160_video": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/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)

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "143_image",
    "160_video",
    "155_positive_prompt"
  ],
  "properties": {
    "160_video": {
      "title": "Vídeo de referência",
      "description": "Vídeo de referência necessário que fornece o movimento a seguir.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.mp4"
    },
    "143_image": {
      "title": "Imagem de retrato",
      "description": "Imagem de retrato necessária do assunto a ser animado.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/comfyui-defaults/163b6a8a-8efc-4c2f-b1c3-cc04f73067ec/input/Runcomfy_example_1268_1.png"
    },
    "155_positive_prompt": {
      "title": "Prompt",
      "description": "Texto obrigatório que descreve a ação, expressão ou direção visual desejada.",
      "type": "string",
      "default": "woman acting"
    },
    "169_valuex170_value": {
      "title": "Resolução (W:H)",
      "description": "Dimensões de saída. Escolha uma das dez predefinições listadas de quadrado, retrato ou paisagem; padrão: 720x720 (1:1).",
      "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": "Número de quadros",
      "description": "Número de quadros de saída. Escolha 81 ou 141; padrão: 81.",
      "type": "integer",
      "enum": [
        81,
        141
      ],
      "default": 81
    },
    "163_frame_rate": {
      "title": "Quadros por segundo",
      "description": "Taxa de quadros de reprodução de 12 a 24 FPS; padrão: 16.",
      "type": "integer",
      "default": 16,
      "minimum": 12,
      "maximum": 24
    },
    "150_strength": {
      "title": "Força do retrato",
      "description": "Controla a influência da incorporação Fantasy Portrait. Valores mais altos enfatizam o retrato e as expressões; intervalo: 0,3–2,0, padrão: 1.",
      "type": "float",
      "default": 1,
      "minimum": 0.3,
      "maximum": 2
    },
    "149_seed": {
      "title": "Seed",
      "description": "Semente inteira usada para reproduzir ou variar uma geração; padrão: 96860978.",
      "type": "integer",
      "default": 96860978
    },
    "149_steps": {
      "title": "Etapas de amostragem",
      "description": "Iterações de remoção de ruído. Mais etapas podem refinar os detalhes e a estabilidade, mas demoram mais; intervalo: 6–20, padrão: 6.",
      "type": "integer",
      "default": 6,
      "minimum": 6,
      "maximum": 20
    },
    "149_cfg": {
      "title": "Escala de aderência ao prompt",
      "description": "Controla a aderência ao prompt versus variação criativa; intervalo: 0,6–2,0, padrão: 1.",
      "type": "float",
      "default": 1,
      "minimum": 0.6,
      "maximum": 2
    },
    "149_shift": {
      "title": "Deslocamento de amostragem",
      "description": "Compensa o cronograma de amostragem. Valores mais altos favorecem movimentos ou estilos mais fortes em vez de estabilidade; intervalo: 1–15, padrão: 5.",
      "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"
        }
      }
    }
  }
}

Fantasy Portrait: Gerador de retrato de imagem para vídeo | RunComfy

Anime um retrato a partir de um vídeo e prompt de referência, com resolução selecionável, contagem de quadros, taxa de quadros, controles de amostragem e sementes.

Índice

1. Introdução

2. Autenticação

3. Referência da API

Enviar uma solicitação

Status da solicitação

Obter resultados

Cancelar solicitação

4. Arquivos de entrada

Arquivo hospedado (URL)

5. Esquema

Esquema de entrada

Esquema de saída

Fantasy Portrait: Gerador de retrato de imagem para vídeo | RunComfy

Anime um retrato a partir de um vídeo e prompt de referência, com resolução selecionável, contagem de quadros, taxa de quadros, controles de amostragem e sementes.

Índice

1. Introdução

2. Autenticação

3. Referência da API

Enviar uma solicitação

Status da solicitação

Obter resultados

Cancelar solicitação

4. Arquivos de entrada

Arquivo hospedado (URL)

5. Esquema

Esquema de entrada

Esquema de saída