Saltar para o conteúdo principal
O provider CometAPI para o AI SDK dá a você acesso a mais de 500 modelos de IA por meio de uma interface TypeScript unificada. Use-o para adicionar geração de texto, streaming, embeddings e geração de imagens a qualquer aplicação Node.js ou runtime Edge.

​
Recursos compatíveis

RecursoMétodoStatus
Geração de textogenerateText()Compatível
Streaming de textostreamText()Compatível
Embeddings de textotextEmbeddingModel()Compatível
Geração de imagensimageModel()Compatível

​
Pré-requisitos

1

Instale o provider

Instale @cometapi/ai-sdk-provider junto com o pacote principal do AI SDK:
npm install @cometapi/ai-sdk-provider ai
2

Defina sua chave de API

O provider lê a variável de ambiente COMETAPI_KEY por padrão:
export COMETAPI_KEY=<COMETAPI_KEY>
Use variáveis de ambiente para evitar codificar credenciais diretamente no seu código-fonte.
3

Importe o provider

Importe a instância padrão do provider:
import { cometapi } from '@cometapi/ai-sdk-provider';
Para substituir a chave de API, a URL base ou outras configurações, use createCometAPI:
import { createCometAPI } from '@cometapi/ai-sdk-provider';

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

​
Uso

​
Gerar texto

Use generateText() para uma resposta única: 
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);

​
Transmitir texto em streaming

Use streamText() para saída em blocos em tempo 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);
}

​
Gerar embeddings

Use textEmbeddingModel() para criar embeddings vetoriais: 
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);

​
Gerar imagens

Use imageModel() para gerar imagens 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',
});

​
Configuração do provider

createCometAPI aceita as seguintes opções:
OpçãoTipoPadrãoDescrição
apiKeystringprocess.env.COMETAPI_KEYChave de API da CometAPI
baseURLstringhttps://api.cometapi.com/v1URL base da API
headersRecord<string, string>—Cabeçalhos de requisição personalizados
fetchFetchFunction—Implementação personalizada de fetch

​
Métodos de modelo

O provider expõe vários construtores de modelo:
MétodoRetornaCaso de uso
cometapi(modelId)LanguageModelV2Geração de texto e streaming (abreviação)
cometapi.chatModel(modelId)LanguageModelV2Chat completions
cometapi.completionModel(modelId)LanguageModelV2Conclusões de texto
cometapi.languageModel(modelId)LanguageModelV2Alias para chatModel
cometapi.textEmbeddingModel(modelId)EmbeddingModelV2Embeddings de texto
cometapi.imageModel(modelId)ImageModelV2Geração de imagens
Navegue pela lista completa de model IDs disponíveis na página de modelos.
  • Seleção de modelo: Qualquer modelo do catálogo de modelos da CometAPI funciona com o método de modelo correspondente — modelos de chat via cometapi(), modelos de embedding via textEmbeddingModel(), modelos de imagem via imageModel().
  • Ajuste fino das respostas: Passe temperature, maxTokens e topP diretamente para generateText() ou streamText(), por exemplo generateText(\{..., temperature: 0.7\}).
  • Tratamento de erros: Envolva as chamadas em try/catch para lidar com erros de autenticação, limites de taxa ou problemas de rede.
  • Segurança: Nunca envie chaves de API para o controle de versão. Use variáveis de ambiente ou um gerenciador de segredos.
  • Limites de taxa: Monitore o uso no console da CometAPI.

​
Recursos relacionados