Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Provider CometAPI dla AI SDK daje dostęp do ponad 500 modeli AI przez ujednolicony interfejs TypeScript. Użyj go, aby dodać generowanie tekstu, Streaming, Embeddings i generowanie obrazów do dowolnej aplikacji działającej w środowisku Node.js lub Edge runtime.

​
Obsługiwane funkcje

FunkcjaMetodaStatus
Generowanie tekstugenerateText()Obsługiwane
Streaming tekstustreamText()Obsługiwane
Embeddings tekstutextEmbeddingModel()Obsługiwane
Generowanie obrazówimageModel()Obsługiwane

​
Wymagania wstępne

1

Zainstaluj provider

Zainstaluj @cometapi/ai-sdk-provider wraz z głównym pakietem AI SDK:
npm install @cometapi/ai-sdk-provider ai
2

Ustaw klucz API

Provider domyślnie odczytuje zmienną środowiskową COMETAPI_KEY:
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY
Używaj zmiennych środowiskowych, aby uniknąć umieszczania poświadczeń na stałe w kodzie źródłowym.
3

Zaimportuj provider

Zaimportuj domyślną instancję providera:
import { cometapi } from '@cometapi/ai-sdk-provider';
Aby nadpisać klucz API, bazowy URL lub inne ustawienia, użyj 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
});

​
Użycie

​
Generowanie tekstu

Użyj generateText() do uzyskania pojedynczej odpowiedzi: 
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);

​
Streaming tekstu

Użyj streamText() do otrzymywania wyniku w czasie rzeczywistym, fragment po fragmencie: 
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);
}

​
Generowanie embeddings

Użyj textEmbeddingModel() do tworzenia embeddings wektorowych: 
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);

​
Generowanie obrazów

Użyj imageModel() do generowania obrazów na podstawie promptów tekstowych: 
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',
});

​
Konfiguracja providera

createCometAPI przyjmuje następujące opcje:
OpcjaTypDomyślnieOpis
apiKeystringprocess.env.COMETAPI_KEYKlucz API CometAPI
baseURLstringhttps://api.cometapi.com/v1Bazowy URL API
headersRecord<string, string>—Niestandardowe nagłówki żądań
fetchFetchFunction—Niestandardowa implementacja fetch

​
Metody modeli

Provider udostępnia kilka konstruktorów modeli:
MetodaZwracaZastosowanie
cometapi(modelId)LanguageModelV2Generowanie tekstu i Streaming (skrócona forma)
cometapi.chatModel(modelId)LanguageModelV2Chat completions
cometapi.completionModel(modelId)LanguageModelV2Uzupełnianie tekstu
cometapi.languageModel(modelId)LanguageModelV2Alias dla chatModel
cometapi.textEmbeddingModel(modelId)EmbeddingModelV2Embeddings tekstu
cometapi.imageModel(modelId)ImageModelV2Generowanie obrazów
Pełną listę dostępnych model IDs znajdziesz na stronie Models.
  • Wybór modelu: Każdy model z katalogu modeli CometAPI działa z odpowiadającą mu metodą modelu — modele chat przez cometapi(), modele embedding przez textEmbeddingModel(), modele obrazów przez imageModel().
  • Dostrajanie odpowiedzi: Przekaż temperature, maxTokens i topP bezpośrednio do generateText() lub streamText(), np. generateText(\{..., temperature: 0.7\}).
  • Obsługa błędów: Opakuj wywołania w try/catch, aby obsługiwać błędy uwierzytelniania, limity szybkości lub problemy z siecią.
  • Bezpieczeństwo: Nigdy nie zapisuj kluczy API w systemie kontroli wersji. Używaj zmiennych środowiskowych lub menedżera sekretów.
  • Limity szybkości: Monitoruj użycie w konsoli CometAPI.

​
Powiązane zasoby