API Community Fantasy Portrait | Prezzi e documentazione

community/fantasy-portrait/image-to-video

Anima un ritratto da un video e un prompt di riferimento, con risoluzione, conteggio fotogrammi, frequenza fotogrammi, controlli di campionamento e seed selezionabili.

Indice

1. Per iniziare

Usa l'API RunComfy per eseguire community/fantasy-portrait/image-to-video. Per input e output accettati, consulta lo schema.

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. Autenticazione

Imposta la variabile d'ambiente YOUR_API_TOKEN con la tua chiave API (gestione nel Profilo) e includi in ogni richiesta un token Bearer nell'intestazione Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Riferimento API

Invia una richiesta

Invia un job di generazione asincrono e ricevi subito un request_id e URL per stato, risultati e annullamento.

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"
  }'

Stato della richiesta

Recupera lo stato corrente per un request_id ("in_queue", "in_progress", "completed" o "cancelled").

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

Recupera i risultati

Recupera output finali e metadati per il request_id; se il job non è completo, la risposta restituisce lo stato corrente per continuare il polling.

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

Annulla richiesta

Annulla un job in coda tramite request_id; i job in corso non possono essere annullati.

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

4. File in ingresso

File ospitato (URL)

Fornisci un URL HTTPS raggiungibile pubblicamente. L'host deve consentire fetch lato server (senza login/cookie), senza rate limit eccessivo o blocco bot. Consigliato: immagini ≤ 50 MB (~4K), video ≤ 100 MB (~2–5 min a 720p). Per asset privati, URL stabili o pre-firmati.

5. Schema

Schema di input

{
  "type": "object",
  "title": "Schema di input",
  "required": [
    "143_image",
    "160_video",
    "155_positive_prompt"
  ],
  "properties": {
    "160_video": {
      "title": "Video di riferimento",
      "description": "È richiesto un video di riferimento che fornisca la movimento da seguire.",
      "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": "Immagine ritratto",
      "description": "Immagine ritratto richiesta del soggetto da animare.",
      "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": "Testo obbligatorio che descrive l'azione, l'espressione o la direzione visiva desiderata.",
      "type": "string",
      "default": "woman acting"
    },
    "169_valuex170_value": {
      "title": "Risoluzione (L:A)",
      "description": "Dimensioni di uscita. Scegli uno dei dieci preset quadrati, verticali o orizzontali elencati; impostazione predefinita: 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": "Numero di fotogrammi",
      "description": "Numero di fotogrammi di output. Scegli 81 o 141; predefinito: 81.",
      "type": "integer",
      "enum": [
        81,
        141
      ],
      "default": 81
    },
    "163_frame_rate": {
      "title": "Fotogrammi al secondo",
      "description": "Frequenza fotogrammi in riproduzione da 12 a 24 FPS; predefinito: 16.",
      "type": "integer",
      "default": 16,
      "minimum": 12,
      "maximum": 24
    },
    "150_strength": {
      "title": "Forza del ritratto",
      "description": "Controlla l'influenza dell'incorporamento Fantasy Portrait. Valori più alti enfatizzano il ritratto e le espressioni; intervallo: 0,3–2,0, predefinito: 1.",
      "type": "float",
      "default": 1,
      "minimum": 0.3,
      "maximum": 2
    },
    "149_seed": {
      "title": "Seed",
      "description": "Seme intero utilizzato per riprodurre o variare una generazione; predefinito: 96860978.",
      "type": "integer",
      "default": 96860978
    },
    "149_steps": {
      "title": "Passaggi di campionamento",
      "description": "Iterazioni di denoising. Ulteriori passaggi possono affinare i dettagli e la stabilità ma richiedono più tempo; intervallo: 6–20, predefinito: 6.",
      "type": "integer",
      "default": 6,
      "minimum": 6,
      "maximum": 20
    },
    "149_cfg": {
      "title": "Scala di guida",
      "description": "Controlla l'fedeltà al prompt rispetto alla variazione creativa; intervallo: 0,6–2,0, predefinito: 1.",
      "type": "float",
      "default": 1,
      "minimum": 0.6,
      "maximum": 2
    },
    "149_shift": {
      "title": "Spostamento del campionamento",
      "description": "Compensa il programma di campionamento. Valori più alti favoriscono un movimento o uno stile più forte rispetto alla stabilità; intervallo: 1–15, predefinito: 5.",
      "type": "integer",
      "default": 5,
      "minimum": 1,
      "maximum": 15
    }
  }
}

Schema di output

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL immagine singola"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL video singolo"
      },
      "images": {
        "type": "array",
        "description": "più URL immagine",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "più URL video",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy è la piattaforma principale ComfyUI che offre ComfyUI online ambiente e servizi, insieme a workflow di ComfyUI con visuali mozzafiato. RunComfy offre anche AI Models, consentire agli artisti di sfruttare gli ultimi strumenti di AI per creare arte incredibile.

1. Per iniziare

Usa l'API RunComfy per eseguire community/fantasy-portrait/image-to-video. Per input e output accettati, consulta lo schema.

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. Riferimento API

Invia una richiesta

Invia un job di generazione asincrono e ricevi subito un request_id e URL per stato, risultati e annullamento.

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"
  }'

Stato della richiesta

Recupera lo stato corrente per un request_id ("in_queue", "in_progress", "completed" o "cancelled").

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

Recupera i risultati

Recupera output finali e metadati per il request_id; se il job non è completo, la risposta restituisce lo stato corrente per continuare il polling.

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

Annulla richiesta

Annulla un job in coda tramite request_id; i job in corso non possono essere annullati.

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

5. Schema

Schema di input

{
  "type": "object",
  "title": "Schema di input",
  "required": [
    "143_image",
    "160_video",
    "155_positive_prompt"
  ],
  "properties": {
    "160_video": {
      "title": "Video di riferimento",
      "description": "È richiesto un video di riferimento che fornisca la movimento da seguire.",
      "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": "Immagine ritratto",
      "description": "Immagine ritratto richiesta del soggetto da animare.",
      "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": "Testo obbligatorio che descrive l'azione, l'espressione o la direzione visiva desiderata.",
      "type": "string",
      "default": "woman acting"
    },
    "169_valuex170_value": {
      "title": "Risoluzione (L:A)",
      "description": "Dimensioni di uscita. Scegli uno dei dieci preset quadrati, verticali o orizzontali elencati; impostazione predefinita: 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": "Numero di fotogrammi",
      "description": "Numero di fotogrammi di output. Scegli 81 o 141; predefinito: 81.",
      "type": "integer",
      "enum": [
        81,
        141
      ],
      "default": 81
    },
    "163_frame_rate": {
      "title": "Fotogrammi al secondo",
      "description": "Frequenza fotogrammi in riproduzione da 12 a 24 FPS; predefinito: 16.",
      "type": "integer",
      "default": 16,
      "minimum": 12,
      "maximum": 24
    },
    "150_strength": {
      "title": "Forza del ritratto",
      "description": "Controlla l'influenza dell'incorporamento Fantasy Portrait. Valori più alti enfatizzano il ritratto e le espressioni; intervallo: 0,3–2,0, predefinito: 1.",
      "type": "float",
      "default": 1,
      "minimum": 0.3,
      "maximum": 2
    },
    "149_seed": {
      "title": "Seed",
      "description": "Seme intero utilizzato per riprodurre o variare una generazione; predefinito: 96860978.",
      "type": "integer",
      "default": 96860978
    },
    "149_steps": {
      "title": "Passaggi di campionamento",
      "description": "Iterazioni di denoising. Ulteriori passaggi possono affinare i dettagli e la stabilità ma richiedono più tempo; intervallo: 6–20, predefinito: 6.",
      "type": "integer",
      "default": 6,
      "minimum": 6,
      "maximum": 20
    },
    "149_cfg": {
      "title": "Scala di guida",
      "description": "Controlla l'fedeltà al prompt rispetto alla variazione creativa; intervallo: 0,6–2,0, predefinito: 1.",
      "type": "float",
      "default": 1,
      "minimum": 0.6,
      "maximum": 2
    },
    "149_shift": {
      "title": "Spostamento del campionamento",
      "description": "Compensa il programma di campionamento. Valori più alti favoriscono un movimento o uno stile più forte rispetto alla stabilità; intervallo: 1–15, predefinito: 5.",
      "type": "integer",
      "default": 5,
      "minimum": 1,
      "maximum": 15
    }
  }
}

Schema di output

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL immagine singola"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL video singolo"
      },
      "images": {
        "type": "array",
        "description": "più URL immagine",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "più URL video",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

Fantasy Portrait: generatore di immagini in video con ritratto | RunComfy

Anima un ritratto da un video e un prompt di riferimento, con risoluzione, conteggio fotogrammi, frequenza fotogrammi, controlli di campionamento e seed selezionabili.

Indice

1. Per iniziare

2. Autenticazione

3. Riferimento API

Invia una richiesta

Stato della richiesta

Recupera i risultati

Annulla richiesta

4. File in ingresso

File ospitato (URL)

5. Schema

Schema di input

Schema di output

Fantasy Portrait: generatore di immagini in video con ritratto | RunComfy

Anima un ritratto da un video e un prompt di riferimento, con risoluzione, conteggio fotogrammi, frequenza fotogrammi, controlli di campionamento e seed selezionabili.

Indice

1. Per iniziare

2. Autenticazione

3. Riferimento API

Invia una richiesta

Stato della richiesta

Recupera i risultati

Annulla richiesta

4. File in ingresso

File ospitato (URL)

5. Schema

Schema di input

Schema di output