> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connettere Dify a CometAPI

> Usa questa guida per collegare Dify a CometAPI impostando l'URL di base, la chiave API e le opzioni del model o del provider.

[Dify](https://dify.ai) è una piattaforma open-source per lo sviluppo di applicazioni LLM. Collegandola a CometAPI, puoi usare gli attuali model ID di CometAPI all'interno dei builder di workflow, chatbot e agent di Dify.

## Prerequisiti

* Un account CometAPI con una chiave API attiva — [accedi per ottenerne una](https://www.cometapi.com)
* Un account Dify — [cloud](https://cloud.dify.ai/signin) o self-hosted

## Metodo 1: plugin CometAPI (consigliato)

Il modo più semplice per connettersi. Il Marketplace di Dify fornisce un plugin ufficiale di CometAPI che gestisce automaticamente l'integrazione.

<Steps>
  <Step title="Ottieni la tua chiave API di CometAPI">
    Accedi alla [dashboard di CometAPI](https://www.cometapi.com/console). Fai clic su **Add API Key** e copia la tua chiave.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Dashboard di CometAPI che mostra il pulsante Add API Key e l'elenco delle chiavi" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Dettagli della chiave API di CometAPI che mostrano l'URL di base https://api.cometapi.com" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Installa il plugin CometAPI in Dify">
    In Dify, vai su **Plugins** → **Install Plugin** → **Marketplace**. Cerca `cometapi` e installalo.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360267.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=85e4b1a60c912aa98c182ed731cde19f" alt="Risultati di ricerca del marketplace dei plugin di Dify che mostrano il plugin CometAPI" width="1875" height="916" data-path="images/integrations/810968_360267.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_360269.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=695d0f5fde8d4c8aad398048b3b504fd" alt="Finestra di conferma dell'installazione del plugin CometAPI in Dify" width="1865" height="896" data-path="images/integrations/810968_360269.png" />
    </Frame>
  </Step>

  <Step title="Aggiungi la tua chiave API">
    Vai su **Settings** → **Model Provider** → **CometAPI** → **Open Settings**. Incolla la tua chiave API di CometAPI e fai clic su **Save**.
  </Step>

  <Step title="Aggiungi modelli">
    Inserisci un model ID dalla [pagina Modelli di CometAPI](/it/overview/models) e fai clic su **Add**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362636.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=9aee58e6532ba58d69eb7673e6c45293" alt="Impostazioni del provider di modelli di Dify che mostrano il modulo di configurazione di CometAPI" width="1256" height="880" data-path="images/integrations/810968_362636.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362637.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=46c8b360d87cfad2adc1cd9f18dd7f25" alt="Elenco dei modelli di Dify con i modelli CometAPI aggiunti correttamente" width="1935" height="870" data-path="images/integrations/810968_362637.png" />
    </Frame>
  </Step>

  <Step title="Testa la connessione">
    Crea un chatbot o un workflow e seleziona un modello CometAPI. Invia un messaggio di test: una risposta riuscita conferma che l'integrazione funziona.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_362638.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=c729bbc0f3bef82a89305434c08ec313" alt="Interfaccia chat di Dify che mostra una risposta riuscita da un modello CometAPI" width="1910" height="924" data-path="images/integrations/810968_362638.png" />
    </Frame>
  </Step>
</Steps>

## Metodo 2: provider compatibile con OpenAI

Usa questo metodo per aggiungere modelli non coperti dal plugin CometAPI, come Claude, Grok o Gemini, oppure per usare nomi di modello personalizzati.

<Steps>
  <Step title="Apri le impostazioni del provider di modelli">
    Vai su **Settings** → **Model Provider** → **OpenAI-API-compatible** → **Add Model**.
  </Step>

  <Step title="Configura il modello">
    Compila i seguenti campi:

    | Field            | Value                                                 |
    | ---------------- | ----------------------------------------------------- |
    | Tipo di modello  | LLM                                                   |
    | Nome del modello | Model ID da CometAPI (deve corrispondere esattamente) |
    | Chiave API       | La tua chiave API di CometAPI                         |
    | URL di base API  | `https://api.cometapi.com/v1`                         |

    Fai clic su **Save**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_354447.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=a6752a58cf43a3c7658da7b276ed5c1e" alt="Modulo del provider compatibile con OpenAI di Dify con i valori di CometAPI compilati" width="1910" height="1009" data-path="images/integrations/810968_354447.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/E4FFvyMYmaOZoldp/images/integrations/810968_354448.png?fit=max&auto=format&n=E4FFvyMYmaOZoldp&q=85&s=18caf18d11f4f0aa6741471016bcb14f" alt="Elenco dei modelli di Dify che mostra una nuova voce di modello compatibile con CometAPI appena salvata" width="1953" height="965" data-path="images/integrations/810968_354448.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Per gli identificatori dei modelli, fai riferimento alla [pagina Modelli di CometAPI](/it/overview/models). Il model ID in Dify deve corrispondere esattamente all'identificatore usato in CometAPI.
</Tip>

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="La chiave API non funziona">
    Verifica che la chiave API sia corretta e disponga di saldo disponibile.
  </Accordion>

  <Accordion title="Il model ID non funziona">
    Verifica che il model ID corrisponda esattamente a quanto previsto da CometAPI.
  </Accordion>

  <Accordion title="L'URL base dell'API non funziona">
    Verifica che l'URL base dell'API includa `/v1` per il metodo compatibile con OpenAI.
  </Accordion>

  <Accordion title="Ulteriore aiuto">
    Visita la [pagina di supporto di CometAPI](https://www.cometapi.com/support/).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/dify#howto",
        "name": "Collega Dify a CometAPI",
        "description": "Usa questa guida per collegare Dify a CometAPI impostando l'URL base, la chiave API e le opzioni del modello o del provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-1",
            "position": 1,
            "name": "Ottieni la tua chiave API di CometAPI",
            "text": "Crea o apri il tuo account CometAPI, quindi copia una chiave API attiva dalla dashboard."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-2",
            "position": 2,
            "name": "Installa il plugin CometAPI in Dify",
            "text": "Completa il passaggio Installa il plugin CometAPI in Dify nella guida Collega Dify a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-3",
            "position": 3,
            "name": "Aggiungi la tua chiave API",
            "text": "Completa il passaggio Aggiungi la tua chiave API nella guida Collega Dify a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-4",
            "position": 4,
            "name": "Aggiungi modelli",
            "text": "Completa il passaggio Aggiungi modelli nella guida Collega Dify a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-5",
            "position": 5,
            "name": "Testa la connessione",
            "text": "Seleziona un model ID attuale dalla pagina CometAPI Models, quindi invia una richiesta di test dall'integrazione."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-6",
            "position": 6,
            "name": "Apri le impostazioni del provider del modello",
            "text": "Completa il passaggio Apri le impostazioni del provider del modello nella guida Collega Dify a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/dify#step-7",
            "position": 7,
            "name": "Configura il modello",
            "text": "Completa il passaggio Configura il modello nella guida Collega Dify a CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentazione CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrazioni",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Collega Dify a CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/dify"
          }
        ]
      }
    ]
    }
    `}
</script>