Vai al contenuto principale
Il provider CometAPI per l’AI SDK ti offre accesso a oltre 500 modelli AI tramite un’interfaccia TypeScript unificata. Usalo per aggiungere generazione di testo, Streaming, Embeddings e generazione di immagini a qualsiasi applicazione Node.js o Edge runtime.

​
Funzionalità supportate

FunzionalitàMetodoStato
Generazione di testogenerateText()Supportato
Streaming di testostreamText()Supportato
Embeddings di testotextEmbeddingModel()Supportato
Generazione di immaginiimageModel()Supportato

​
Prerequisiti

  • Node.js 18+
  • Un account CometAPI con una API key attiva — ottienila qui
1

Installa il provider

Installa @cometapi/ai-sdk-provider insieme al pacchetto core dell’AI SDK:
npm install @cometapi/ai-sdk-provider ai
2

Imposta la tua API key

Il provider legge per impostazione predefinita la variabile d’ambiente COMETAPI_KEY:
export COMETAPI_KEY=<COMETAPI_KEY>
Usa le variabili d’ambiente per evitare di inserire credenziali hardcoded nel codice sorgente.
3

Importa il provider

Importa l’istanza predefinita del provider:
import { cometapi } from '@cometapi/ai-sdk-provider';
Per sovrascrivere la API key, l’URL di base o altre impostazioni, usa createCometAPI:
import { createCometAPI } from '@cometapi/ai-sdk-provider';

const cometapi = createCometAPI({
  apiKey: '<COMETAPI_KEY>',       // override env variable
  baseURL: 'https://api.cometapi.com/v1',  // default
});

​
Utilizzo

​
Genera testo

Usa generateText() per una risposta singola: 
import { cometapi } from '@cometapi/ai-sdk-provider';
import { generateText } from 'ai';

const { text } = await generateText({
  model: cometapi('your-model-id'),
  prompt: 'What is CometAPI?',
});

console.log(text);

​
Trasmetti testo in streaming

Usa streamText() per un output in chunk in tempo reale: 
import { cometapi } from '@cometapi/ai-sdk-provider';
import { streamText } from 'ai';

const result = streamText({
  model: cometapi('your-model-id'),
  prompt: 'Write a short story about AI.',
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

​
Genera embeddings

Usa textEmbeddingModel() per creare embeddings vettoriali: 
import { cometapi } from '@cometapi/ai-sdk-provider';

const model = cometapi.textEmbeddingModel('text-embedding-3-small');

// Single embedding
const single = await model.doEmbed({ values: ['Hello, world!'] });
console.log('Dimensions:', single.embeddings[0].length);

// Batch embeddings
const batch = await model.doEmbed({
  values: ['sunny day', 'rainy afternoon', 'cold winter night'],
});
console.log('Count:', batch.embeddings.length);

​
Genera immagini

Usa imageModel() per generare immagini da prompt testuali: 
import { cometapi } from '@cometapi/ai-sdk-provider';
import { experimental_generateImage as generateImage } from 'ai';

const { image } = await generateImage({
  model: cometapi.imageModel('your-model-id'),
  prompt: 'A beautiful sunset over mountains',
});

​
Configurazione del provider

createCometAPI accetta le seguenti opzioni:
OpzioneTipoPredefinitoDescrizione
apiKeystringprocess.env.COMETAPI_KEYAPI key di CometAPI
baseURLstringhttps://api.cometapi.com/v1URL di base dell’API
headersRecord<string, string>—Header di richiesta personalizzati
fetchFetchFunction—Implementazione fetch personalizzata

​
Metodi del modello

Il provider espone diversi costruttori di modelli:
MetodoRestituisceCaso d’uso
cometapi(modelId)LanguageModelV2Generazione di testo e Streaming (abbreviazione)
cometapi.chatModel(modelId)LanguageModelV2Chat completions
cometapi.completionModel(modelId)LanguageModelV2Text completions
cometapi.languageModel(modelId)LanguageModelV2Alias di chatModel
cometapi.textEmbeddingModel(modelId)EmbeddingModelV2Embeddings di testo
cometapi.imageModel(modelId)ImageModelV2Generazione di immagini
Sfoglia l’elenco completo dei model ID disponibili nella pagina Models.
  • Selezione del modello: Qualsiasi modello del catalogo modelli CometAPI funziona con il metodo modello corrispondente — modelli chat tramite cometapi(), modelli embedding tramite textEmbeddingModel(), modelli immagine tramite imageModel().
  • Ottimizzazione delle risposte: Passa temperature, maxTokens e topP direttamente a generateText() o streamText(), ad esempio generateText(\{..., temperature: 0.7\}).
  • Gestione degli errori: Inserisci le chiamate in try/catch per gestire errori di autenticazione, rate limit o problemi di rete.
  • Sicurezza: Non salvare mai le API key nel controllo versione. Usa variabili d’ambiente o un gestore di segreti.
  • Rate limit: Monitora l’utilizzo nella console CometAPI.

​
Risorse correlate