> ## 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.

# AI SDK mit CometAPI verwenden

> Verwenden Sie diesen Leitfaden, um AI SDK mit CometAPI zu konfigurieren, indem Sie die base URL, den API key sowie model- oder provider-Optionen festlegen.

Der [CometAPI-Provider für das AI SDK](https://github.com/cometapi-dev/ai-sdk-provider) bietet Ihnen Zugriff auf über 500 KI-Modelle über eine einheitliche TypeScript-Schnittstelle. Verwenden Sie ihn, um Textgenerierung, Streaming, Embeddings und Bildgenerierung zu jeder Node.js- oder Edge-Runtime-Anwendung hinzuzufügen.

## Unterstützte Funktionen

| Funktion        | Methode                | Status      |
| --------------- | ---------------------- | ----------- |
| Textgenerierung | `generateText()`       | Unterstützt |
| Text-Streaming  | `streamText()`         | Unterstützt |
| Text-Embeddings | `textEmbeddingModel()` | Unterstützt |
| Bildgenerierung | `imageModel()`         | Unterstützt |

## Voraussetzungen

* Node.js 18+
* Ein CometAPI-Konto mit einem aktiven API key — [holen Sie sich Ihren hier](https://www.cometapi.com/console/token)

<Steps>
  <Step title="Installieren Sie den Provider">
    Installieren Sie `@cometapi/ai-sdk-provider` zusammen mit dem AI SDK-Core-Paket:

    <CodeGroup>
      ```bash npm theme={null}
      npm install @cometapi/ai-sdk-provider ai
      ```

      ```bash pnpm theme={null}
      pnpm add @cometapi/ai-sdk-provider ai
      ```

      ```bash yarn theme={null}
      yarn add @cometapi/ai-sdk-provider ai
      ```
    </CodeGroup>
  </Step>

  <Step title="Legen Sie Ihren API key fest">
    Der Provider liest standardmäßig die Umgebungsvariable `COMETAPI_KEY`:

    ```bash theme={null}
    read -rsp "CometAPI API key: " COMETAPI_KEY
    printf '\n'
    export COMETAPI_KEY
    ```

    <Note>
      Verwenden Sie Umgebungsvariablen, um zu vermeiden, Anmeldedaten fest im Quellcode zu hinterlegen.
    </Note>
  </Step>

  <Step title="Importieren Sie den Provider">
    Importieren Sie die Standard-Provider-Instanz:

    ```typescript theme={null}
    import { cometapi } from '@cometapi/ai-sdk-provider';
    ```

    Um den API key, die base URL oder andere Einstellungen zu überschreiben, verwenden Sie `createCometAPI`:

    ```typescript theme={null}
    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
    });
    ```
  </Step>
</Steps>

## Verwendung

### Text generieren

Verwenden Sie `generateText()` für eine einzelne Antwort:

```typescript theme={null}
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);
```

### Text streamen

Verwenden Sie `streamText()` für eine Ausgabe in Echtzeit in Blöcken:

```typescript theme={null}
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 generieren

Verwenden Sie `textEmbeddingModel()`, um Vektor-Embeddings zu erstellen:

```typescript theme={null}
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);
```

### Bilder generieren

Verwenden Sie `imageModel()`, um Bilder aus Text-Prompts zu generieren:

```typescript theme={null}
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',
});
```

## Anbieter-Konfiguration

`createCometAPI` akzeptiert die folgenden Optionen:

| Option    | Typ                      | Standard                      | Beschreibung                             |
| --------- | ------------------------ | ----------------------------- | ---------------------------------------- |
| `apiKey`  | `string`                 | `process.env.COMETAPI_KEY`    | CometAPI API-Schlüssel                   |
| `baseURL` | `string`                 | `https://api.cometapi.com/v1` | API-Basis-URL                            |
| `headers` | `Record<string, string>` | —                             | Benutzerdefinierte Request-Header        |
| `fetch`   | `FetchFunction`          | —                             | Benutzerdefinierte Fetch-Implementierung |

## Modellmethoden

Der Anbieter stellt mehrere Modellkonstruktoren bereit:

| Methode                                | Gibt zurück        | Anwendungsfall                           |
| -------------------------------------- | ------------------ | ---------------------------------------- |
| `cometapi(modelId)`                    | `LanguageModelV2`  | Textgenerierung und Streaming (Kurzform) |
| `cometapi.chatModel(modelId)`          | `LanguageModelV2`  | Chat Completions                         |
| `cometapi.completionModel(modelId)`    | `LanguageModelV2`  | Text-Completions                         |
| `cometapi.languageModel(modelId)`      | `LanguageModelV2`  | Alias für `chatModel`                    |
| `cometapi.textEmbeddingModel(modelId)` | `EmbeddingModelV2` | Text-Embeddings                          |
| `cometapi.imageModel(modelId)`         | `ImageModelV2`     | Bildgenerierung                          |

Die vollständige Liste der verfügbaren model IDs finden Sie auf der [Models-Seite](/de/overview/models).

<AccordionGroup>
  <Accordion title="Tipps und Fehlerbehebung">
    * **Modellauswahl**: Jedes Modell aus dem [CometAPI-Modellkatalog](/de/overview/models) funktioniert mit der entsprechenden Modellmethode — Chat-Modelle über `cometapi()`, Embedding-Modelle über `textEmbeddingModel()`, Bildmodelle über `imageModel()`.
    * **Antworten feinabstimmen**: Übergeben Sie `temperature`, `maxTokens` und `topP` direkt an `generateText()` oder `streamText()`, z. B. `generateText(\{..., temperature: 0.7\})`.
    * **Fehlerbehandlung**: Kapseln Sie Aufrufe in `try/catch`, um Authentifizierungsfehler, Ratenbegrenzungen oder Netzwerkprobleme zu behandeln.
    * **Sicherheit**: Committen Sie API-Schlüssel niemals in die Versionsverwaltung. Verwenden Sie Umgebungsvariablen oder einen Secrets-Manager.
    * **Ratenbegrenzungen**: Überwachen Sie die Nutzung in der [CometAPI-Konsole](https://www.cometapi.com/console).
  </Accordion>
</AccordionGroup>

## Verwandte Ressourcen

* [CometAPI AI SDK Provider auf GitHub](https://github.com/cometapi-dev/ai-sdk-provider)
* [@cometapi/ai-sdk-provider auf npm](https://www.npmjs.com/package/@cometapi/ai-sdk-provider)
* [AI SDK-Dokumentation](https://ai-sdk.dev/docs)
* [CometAPI-Schnellstart](/de/overview/quick-start)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/ai-sdk#howto",
        "name": "AI SDK mit CometAPI verwenden",
        "description": "Verwenden Sie diese Anleitung, um AI SDK mit CometAPI zu konfigurieren, indem Sie die base URL, den API-Schlüssel sowie model- oder provider-Optionen festlegen.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/ai-sdk#step-1",
            "position": 1,
            "name": "Den Provider installieren",
            "text": "Schließen Sie den Schritt „Den Provider installieren“ in der Anleitung „AI SDK mit CometAPI verwenden“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/ai-sdk#step-2",
            "position": 2,
            "name": "Ihren API-Schlüssel festlegen",
            "text": "Speichern Sie Ihren CometAPI-API-Schlüssel in der Umgebungsvariable oder im Einstellungsfeld, das von der Integration verwendet wird."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/ai-sdk#step-3",
            "position": 3,
            "name": "Den Provider importieren",
            "text": "Schließen Sie den Schritt „Den Provider importieren“ in der Anleitung „AI SDK mit CometAPI verwenden“ ab."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI-Dokumentation",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrationen",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "AI SDK mit CometAPI verwenden",
            "item": "https://apidoc.cometapi.com/integrations/ai-sdk"
          }
        ]
      }
    ]
    }
    `}
</script>