Funzionalità supportate
Prerequisiti
- Node.js 18+
- Un account CometAPI con una chiave API attiva — ottienila qui
1
Installa il provider
Installa
@cometapi/ai-sdk-provider insieme al pacchetto core di AI SDK:2
Imposta la tua chiave API
Il provider legge la variabile d’ambiente
COMETAPI_KEY per impostazione predefinita:Usa le variabili d’ambiente per evitare di inserire credenziali hardcoded nel codice sorgente.
3
Importa il provider
Importa l’istanza predefinita del provider:Per sovrascrivere la chiave API, l’URL di base o altre impostazioni, usa
createCometAPI:Utilizzo
Genera testo
UsagenerateText() per una risposta singola:
Esegui lo streaming del testo
UsastreamText() per output in tempo reale suddiviso in chunk:
Genera embeddings
UsatextEmbeddingModel() per creare embeddings vettoriali:
Genera immagini
UsaimageModel() per generare immagini da prompt testuali:
Configurazione del provider
createCometAPI accetta le seguenti opzioni:
Metodi del modello
Il provider espone diversi costruttori di modello:
Consulta l’elenco completo dei model ID disponibili nella pagina Models.
Suggerimenti e risoluzione dei problemi
Suggerimenti e risoluzione dei problemi
- Selezione del modello: Qualsiasi modello del catalogo modelli CometAPI funziona con il metodo di modello corrispondente — i modelli chat tramite
cometapi(), i modelli embedding tramitetextEmbeddingModel(), i modelli immagine tramiteimageModel(). - Ottimizzazione delle risposte: Passa
temperature,maxTokensetopPdirettamente agenerateText()ostreamText(), ad esempiogenerateText(\{..., temperature: 0.7\}). - Gestione degli errori: Racchiudi le chiamate in
try/catchper gestire errori di autenticazione, limiti di frequenza o problemi di rete. - Sicurezza: Non salvare mai le chiavi API nel controllo versione. Usa variabili d’ambiente o un gestore di segreti.
- Limiti di frequenza: Monitora l’utilizzo nella console CometAPI.