Utiliser AI SDK avec CometAPI

Le provider CometAPI pour AI SDK vous donne accès à plus de 500 modèles d’IA via une interface TypeScript unifiée. Utilisez-le pour ajouter la génération de texte, le Streaming, les Embeddings et la génération d’images à toute application s’exécutant sur Node.js ou Edge runtime.

Fonctionnalités prises en charge

Fonctionnalité	Méthode	Statut
Génération de texte	`generateText()`	Pris en charge
Streaming de texte	`streamText()`	Pris en charge
Embeddings de texte	`textEmbeddingModel()`	Pris en charge
Génération d’images	`imageModel()`	Pris en charge

Prérequis

Node.js 18+
Un compte CometAPI avec une clé API active — obtenez la vôtre ici

Installer le provider

Installez @cometapi/ai-sdk-provider avec le package principal de AI SDK :

npm install @cometapi/ai-sdk-provider ai

pnpm add @cometapi/ai-sdk-provider ai

yarn add @cometapi/ai-sdk-provider ai

Définir votre clé API

Le provider lit la variable d’environnement COMETAPI_KEY par défaut :

read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

Utilisez des variables d’environnement pour éviter d’intégrer des identifiants en dur dans votre code source.

Importer le provider

Importez l’instance de provider par défaut :

import { cometapi } from '@cometapi/ai-sdk-provider';

Pour remplacer la clé API, l’URL de base ou d’autres paramètres, utilisez createCometAPI :

import { createCometAPI } from '@cometapi/ai-sdk-provider';

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

Utilisation

Générer du texte

Utilisez generateText() pour une réponse en une seule fois :

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);

Diffuser du texte en Streaming

Utilisez streamText() pour une sortie en temps réel par fragments :

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);
}

Générer des Embeddings

Utilisez textEmbeddingModel() pour créer des embeddings vectoriels :

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);

Générer des images

Utilisez imageModel() pour générer des images à partir de prompts textuels :

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',
});

Configuration du provider

createCometAPI accepte les options suivantes :

Option	Type	Par défaut	Description
`apiKey`	`string`	`process.env.COMETAPI_KEY`	Clé API CometAPI
`baseURL`	`string`	`https://api.cometapi.com/v1`	URL de base de l’API
`headers`	`Record<string, string>`	—	En-têtes de requête personnalisés
`fetch`	`FetchFunction`	—	Implémentation personnalisée de fetch

Méthodes de modèle

Le provider expose plusieurs constructeurs de modèle :

Méthode	Retourne	Cas d’usage
`cometapi(modelId)`	`LanguageModelV2`	Génération de texte et Streaming (raccourci)
`cometapi.chatModel(modelId)`	`LanguageModelV2`	Chat Completions
`cometapi.completionModel(modelId)`	`LanguageModelV2`	Complétions de texte
`cometapi.languageModel(modelId)`	`LanguageModelV2`	Alias de `chatModel`
`cometapi.textEmbeddingModel(modelId)`	`EmbeddingModelV2`	Embeddings de texte
`cometapi.imageModel(modelId)`	`ImageModelV2`	Génération d’images

Parcourez la liste complète des model ID disponibles sur la page Models.

Conseils et dépannage

Sélection du modèle : Tout modèle du catalogue de modèles CometAPI fonctionne avec la méthode de modèle correspondante — les modèles de chat via cometapi(), les modèles d’embedding via textEmbeddingModel(), les modèles d’image via imageModel().
Ajustement des réponses : Passez temperature, maxTokens et topP directement à generateText() ou streamText(), par ex. generateText(\{..., temperature: 0.7\}).
Gestion des erreurs : Encapsulez les appels dans try/catch pour gérer les erreurs d’authentification, les limites de débit ou les problèmes réseau.
Sécurité : Ne versionnez jamais les clés API dans le contrôle de version. Utilisez des variables d’environnement ou un gestionnaire de secrets.
Limites de débit : Surveillez l’utilisation dans la console CometAPI.

Vue d'ensemble

Agents de codage IA

Agents IA

Clients de chat IA

Traduction et langue

Plateformes d’automatisation

Observabilité et évaluation

Frameworks IA

Fonctionnalités prises en charge

Prérequis

Utilisation

Générer du texte

Diffuser du texte en Streaming

Générer des Embeddings

Générer des images

Configuration du provider

Méthodes de modèle

Ressources associées

​Fonctionnalités prises en charge

​Prérequis

​Utilisation

​Générer du texte

​Diffuser du texte en Streaming

​Générer des Embeddings

​Générer des images

​Configuration du provider

​Méthodes de modèle

​Ressources associées

Fonctionnalités prises en charge

Prérequis

Utilisation

Générer du texte

Diffuser du texte en Streaming

Générer des Embeddings

Générer des images

Configuration du provider

Méthodes de modèle

Ressources associées