Перейти до основного вмісту
Провайдер CometAPI для AI SDK надає доступ до 500+ AI моделей через уніфікований інтерфейс TypeScript. Використовуйте його, щоб додати генерацію тексту, Streaming, Embeddings і генерацію зображень до будь-якого застосунку для Node.js або Edge runtime.

Підтримувані можливості

МожливістьМетодСтатус
Генерація текстуgenerateText()Підтримується
Потокова передача текстуstreamText()Підтримується
Text embeddingstextEmbeddingModel()Підтримується
Генерація зображеньimageModel()Підтримується

Передумови

1

Встановіть провайдера

Встановіть @cometapi/ai-sdk-provider разом із базовим пакетом AI SDK:
npm install @cometapi/ai-sdk-provider ai
2

Налаштуйте свій API key

За замовчуванням провайдер зчитує змінну середовища COMETAPI_KEY:
export COMETAPI_KEY=<COMETAPI_KEY>
Використовуйте змінні середовища, щоб не хардкодити облікові дані у вихідному коді.
3

Імпортуйте провайдера

Імпортуйте екземпляр провайдера за замовчуванням:
import { cometapi } from '@cometapi/ai-sdk-provider';
Щоб перевизначити API key, base URL або інші налаштування, використовуйте createCometAPI:
import { createCometAPI } from '@cometapi/ai-sdk-provider';

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

Використання

Згенеруйте текст

Використовуйте generateText() для одноразової відповіді:
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);

Транслюйте текст

Використовуйте streamText() для виводу в реальному часі частинами:
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);
}

Згенеруйте embeddings

Використовуйте textEmbeddingModel() для створення векторних embeddings:
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);

Згенеруйте зображення

Використовуйте imageModel() для генерації зображень із текстових Prompt:
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',
});

Конфігурація провайдера

createCometAPI приймає такі параметри:
ПараметрТипЗа замовчуваннямОпис
apiKeystringprocess.env.COMETAPI_KEYAPI key CometAPI
baseURLstringhttps://api.cometapi.com/v1Базовий URL API
headersRecord<string, string>Користувацькі заголовки запиту
fetchFetchFunctionКористувацька реалізація fetch

Методи моделей

Провайдер надає кілька конструкторів моделей:
МетодПовертаєВаріант використання
cometapi(modelId)LanguageModelV2Генерація тексту та Streaming (скорочений запис)
cometapi.chatModel(modelId)LanguageModelV2Chat completions
cometapi.completionModel(modelId)LanguageModelV2Text completions
cometapi.languageModel(modelId)LanguageModelV2Псевдонім для chatModel
cometapi.textEmbeddingModel(modelId)EmbeddingModelV2Text embeddings
cometapi.imageModel(modelId)ImageModelV2Генерація зображень
Перегляньте повний список доступних model IDs на сторінці Models.
  • Вибір моделі: Будь-яка модель із каталогу моделей CometAPI працює з відповідним методом моделі — chat-моделі через cometapi(), embedding-моделі через textEmbeddingModel(), image-моделі через imageModel().
  • Налаштування responses: Передавайте temperature, maxTokens і topP безпосередньо в generateText() або streamText(), наприклад generateText(\{..., temperature: 0.7\}).
  • Обробка помилок: Обгорніть виклики в try/catch, щоб обробляти помилки автентифікації, ліміти запитів або проблеми з мережею.
  • Безпека: Ніколи не комітьте API key у систему контролю версій. Використовуйте змінні середовища або менеджер секретів.
  • Ліміти запитів: Відстежуйте використання в консолі CometAPI.

Пов’язані ресурси