Usa AI SDK con CometAPI

El provider de CometAPI para AI SDK te da acceso a más de 500 modelos de IA a través de una interfaz unificada de TypeScript. Úsalo para agregar generación de texto, Streaming, Embeddings y generación de imágenes a cualquier aplicación de runtime de Node.js o Edge.

Funcionalidades compatibles

Funcionalidad	Método	Estado
Generación de texto	`generateText()`	Compatible
Streaming de texto	`streamText()`	Compatible
Embeddings de texto	`textEmbeddingModel()`	Compatible
Generación de imágenes	`imageModel()`	Compatible

Requisitos previos

Node.js 18+
Una cuenta de CometAPI con una clave API activa — obtén la tuya aquí

Instala el provider

Instala @cometapi/ai-sdk-provider junto con el paquete 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

Configura tu clave API

El provider lee la variable de entorno COMETAPI_KEY de forma predeterminada:

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

Usa variables de entorno para evitar incluir credenciales de forma fija en tu código fuente.

Importa el provider

Importa la instancia predeterminada del provider:

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

Para sobrescribir la clave API, la URL base u otras configuraciones, usa 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
});

Uso

Genera texto

Usa generateText() para una respuesta de una sola vez:

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

Transmite texto

Usa streamText() para una salida fragmentada en tiempo real:

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() para crear Embeddings vectoriales:

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 imágenes

Usa imageModel() para generar imágenes a partir de prompts de texto:

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

Configuración del proveedor

createCometAPI acepta las siguientes opciones:

Opción	Tipo	Predeterminado	Descripción
`apiKey`	`string`	`process.env.COMETAPI_KEY`	Clave de API de CometAPI
`baseURL`	`string`	`https://api.cometapi.com/v1`	URL base de la API
`headers`	`Record<string, string>`	—	Encabezados de solicitud personalizados
`fetch`	`FetchFunction`	—	Implementación personalizada de fetch

Métodos del modelo

El proveedor expone varios constructores de modelos:

Método	Devuelve	Caso de uso
`cometapi(modelId)`	`LanguageModelV2`	Generación de texto y Streaming (abreviado)
`cometapi.chatModel(modelId)`	`LanguageModelV2`	Chat Completions
`cometapi.completionModel(modelId)`	`LanguageModelV2`	Completions de texto
`cometapi.languageModel(modelId)`	`LanguageModelV2`	Alias de `chatModel`
`cometapi.textEmbeddingModel(modelId)`	`EmbeddingModelV2`	Embeddings de texto
`cometapi.imageModel(modelId)`	`ImageModelV2`	Generación de imágenes

Consulta la lista completa de model IDs disponibles en la página de modelos.

Consejos y solución de problemas

Selección de modelo: Cualquier modelo del catálogo de modelos de CometAPI funciona con el método de modelo correspondiente: modelos de chat mediante cometapi(), modelos de embedding mediante textEmbeddingModel(), modelos de imagen mediante imageModel().
Ajuste de respuestas: Pasa temperature, maxTokens y topP directamente a generateText() o streamText(), por ejemplo, generateText(\{..., temperature: 0.7\}).
Manejo de errores: Envuelve las llamadas en try/catch para gestionar errores de autenticación, límites de tasa o problemas de red.
Seguridad: Nunca confirmes claves de API en el control de versiones. Usa variables de entorno o un gestor de secretos.
Límites de tasa: Supervisa el uso en la consola de CometAPI.

Resumen general

Agentes de codificación de IA

Agentes de IA

Clientes de chat de IA

Traducción e idioma

Plataformas de automatización

Observabilidad y evaluación

Frameworks de IA

Funcionalidades compatibles

Requisitos previos

Uso

Genera texto

Transmite texto

Genera Embeddings

Genera imágenes

Configuración del proveedor

Métodos del modelo

Recursos relacionados

​Funcionalidades compatibles

​Requisitos previos

​Uso

​Genera texto

​Transmite texto

​Genera Embeddings

​Genera imágenes

​Configuración del proveedor

​Métodos del modelo

​Recursos relacionados

Funcionalidades compatibles

Requisitos previos

Uso

Genera texto

Transmite texto

Genera Embeddings

Genera imágenes

Configuración del proveedor

Métodos del modelo

Recursos relacionados