API Bytedance Dreamina 4.0 | Prezzi e documentazione

bytedance/dreamina-4-0/edit

Produce 4K edits with structure-aware adjustments, multi-reference fusion, accurate text replacement, and controlled prompt influence.

Indice

1. Per iniziare

Usa l'API RunComfy per eseguire bytedance/dreamina-4-0/edit. Per input e output accettati, consulta lo schema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/bytedance/dreamina-4-0/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-1-input.jpg",
      "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-2-input.jpg"
    ],
    "prompt": "A beautiful girl is sitting on the boat"
  }'

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/bytedance/dreamina-4-0/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-1-input.jpg",
      "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-2-input.jpg"
    ],
    "prompt": "A beautiful girl is sitting on the boat"
  }'

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": [
    "image_urls",
    "prompt"
  ],
  "properties": {
    "image_urls": {
      "title": "Images",
      "description": "Only JPEG and PNG formats are supported; JPEG is recommended. Supports 1–10 images; larger or more images increase processing time. Recommended to use no more than 6 images; too many reference images may reduce quality.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "validations": [
        {
          "validation_rule": "file_size_mb<=",
          "validation_value": 15,
          "validation_error": "Each image file must be ≤ 15 MB."
        },
        {
          "validation_rule": "width_pixels<=",
          "validation_value": 4096,
          "validation_error": "Maximum resolution is 4096x4096."
        },
        {
          "validation_rule": "height_pixels<=",
          "validation_value": 4096,
          "validation_error": "Maximum resolution is 4096x4096."
        },
        {
          "validation_rule": "width/height≥",
          "validation_value": "0.33",
          "validation_error": "The input image aspect ratio must be within [1/3, 3]."
        },
        {
          "validation_rule": "width/height≤",
          "validation_value": "3",
          "validation_error": "The input image aspect ratio must be within [1/3, 3]."
        }
      ],
      "maxItems": 10,
      "minItems": 1,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-1-input.jpg",
        "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-2-input.jpg"
      ]
    },
    "prompt": {
      "title": "prompt",
      "description": "",
      "type": "string",
      "maxLength": 800,
      "default": "A beautiful girl is sitting on the boat"
    },
    "width×height": {
      "title": "Aspect Ratio (W:H)",
      "description": "",
      "type": "string",
      "enum": [
        "1024x1024(1:1)",
        "2048x2048(1:1)",
        "2304x1728(4:3)",
        "2496x1664(3:2)",
        "2560x1440(16:9)",
        "3024x1296(21:9)",
        "4096x4096(1:1)",
        "4694x3520(4:3)",
        "4992x3328(3:2)",
        "5404x3040(16:9)",
        "6198x2656(21:9)"
      ],
      "default": "2048x2048(1:1)"
    },
    "scale": {
      "title": "Scale",
      "description": "Controls how strongly the text prompt influences the result relative to input images. Higher values increase text influence.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0.5
    },
    "force_single": {
      "title": "Force Single Image",
      "description": "Whether to force generation of a single image. More images per set increase latency; for stability, specify group count/resolution or pass width and height.",
      "type": "boolean",
      "default": false
    }
  }
}

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 bytedance/dreamina-4-0/edit. Per input e output accettati, consulta lo schema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/bytedance/dreamina-4-0/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-1-input.jpg",
      "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-2-input.jpg"
    ],
    "prompt": "A beautiful girl is sitting on the boat"
  }'

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/bytedance/dreamina-4-0/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "image_urls": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-1-input.jpg",
      "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-2-input.jpg"
    ],
    "prompt": "A beautiful girl is sitting on the boat"
  }'

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": [
    "image_urls",
    "prompt"
  ],
  "properties": {
    "image_urls": {
      "title": "Images",
      "description": "Only JPEG and PNG formats are supported; JPEG is recommended. Supports 1–10 images; larger or more images increase processing time. Recommended to use no more than 6 images; too many reference images may reduce quality.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "validations": [
        {
          "validation_rule": "file_size_mb<=",
          "validation_value": 15,
          "validation_error": "Each image file must be ≤ 15 MB."
        },
        {
          "validation_rule": "width_pixels<=",
          "validation_value": 4096,
          "validation_error": "Maximum resolution is 4096x4096."
        },
        {
          "validation_rule": "height_pixels<=",
          "validation_value": 4096,
          "validation_error": "Maximum resolution is 4096x4096."
        },
        {
          "validation_rule": "width/height≥",
          "validation_value": "0.33",
          "validation_error": "The input image aspect ratio must be within [1/3, 3]."
        },
        {
          "validation_rule": "width/height≤",
          "validation_value": "3",
          "validation_error": "The input image aspect ratio must be within [1/3, 3]."
        }
      ],
      "maxItems": 10,
      "minItems": 1,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-1-input.jpg",
        "https://playgrounds-storage-public.runcomfy.net/tools/7002/media-files/usecase5-1-2-input.jpg"
      ]
    },
    "prompt": {
      "title": "prompt",
      "description": "",
      "type": "string",
      "maxLength": 800,
      "default": "A beautiful girl is sitting on the boat"
    },
    "width×height": {
      "title": "Aspect Ratio (W:H)",
      "description": "",
      "type": "string",
      "enum": [
        "1024x1024(1:1)",
        "2048x2048(1:1)",
        "2304x1728(4:3)",
        "2496x1664(3:2)",
        "2560x1440(16:9)",
        "3024x1296(21:9)",
        "4096x4096(1:1)",
        "4694x3520(4:3)",
        "4992x3328(3:2)",
        "5404x3040(16:9)",
        "6198x2656(21:9)"
      ],
      "default": "2048x2048(1:1)"
    },
    "scale": {
      "title": "Scale",
      "description": "Controls how strongly the text prompt influences the result relative to input images. Higher values increase text influence.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0.5
    },
    "force_single": {
      "title": "Force Single Image",
      "description": "Whether to force generation of a single image. More images per set increase latency; for stability, specify group count/resolution or pass width and height.",
      "type": "boolean",
      "default": false
    }
  }
}

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

Dreamina 4.0 image-to-image: Generatore visivo AI 4K rapido | Conversione immagine

Produce 4K edits with structure-aware adjustments, multi-reference fusion, accurate text replacement, and controlled prompt influence.

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

Dreamina 4.0 image-to-image: Generatore visivo AI 4K rapido | Conversione immagine

Produce 4K edits with structure-aware adjustments, multi-reference fusion, accurate text replacement, and controlled prompt influence.

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