# OpenAI verbinden

Costfluent liest deine Ausgaben für die OpenAI API aus der Costs API der Organisation, mit einem
Admin-Schlüssel, den du dafür anlegst. Eine Verbindung ist eine OpenAI-Organisation, mit den Kosten
jedes ihrer Projekte.

## Wie Costfluent verbindet

Costfluent speichert den Admin-Schlüssel verschlüsselt und nutzt ihn für eine Abfrage: die täglichen
Kosten der Organisation. OpenAI bietet einem Admin-Schlüssel keine Abfrage, die seine Organisation
nennt. Costfluent erkennt die Verbindung daher an der Organisation, die die Antwort von OpenAI nennt,
oder, wenn sie keine nennt, an einem Fingerabdruck des Schlüssels selbst. Der Schlüssel wird nur für
diese Verbindung verwendet.

:::caution
Wähle beim Anlegen des Schlüssels **Read only**, wo die OpenAI-Plattform es anbietet. Ein Schlüssel
mit vollen Rechten kann auch Mitglieder, Projekte und Schlüssel der Organisation verwalten.
:::

## Voraussetzungen

1. Die Organisationsrolle Eigentümer oder Integrationsverantwortliche Person in Costfluent.
2. Ein Admin-Schlüssel, den ein Organization Owner auf der OpenAI-Plattform unter den **Admin keys**
   der Organisation anlegt. Er beginnt mit `sk-admin-`. Ein Projektschlüssel (`sk-proj-`) kann keine
   Kosten lesen.

## Verbinden

<Stepper>

1. Öffne **Einstellungen**, dann **Integrationen**, wähle **OpenAI** und öffne den Tab
   **Verbinden**.
2. Wähle **Admin-Schlüssel hinzufügen** und füge den Schlüssel in **Admin-Schlüssel** ein.
3. Wähle **Verbindung testen**, um jede Prüfung zu sehen, oder **Verbinden**, um zu speichern.

</Stepper>

Costfluent liest einen Tag Kosten, bevor es etwas speichert. Eine Verbindung, die sich speichern
lässt, kann also deine Kosten lesen. Eine Verbindung mit derselben Identität wie eine bestehende wird
abgelehnt.

:::caution
Verbinde jede Organisation einmal, mit einem Schlüssel. Nennt OpenAI die Organisation nicht, sind
zwei Schlüssel einer Organisation zwei Identitäten, und ihre Ausgaben würden doppelt gezählt.
:::

## Daten und Aktualität

Beim Verbinden werden Kosten so weit zurück importiert, wie die Kostenhistorie deines Plans erlaubt,
höchstens sechs Monate ([Verbindungen verwalten](/de/connect/manage-connections#wie-es-sich-verhält)),
soweit OpenAI so weit zurück Kosten meldet. Kosten kommen pro UTC-Tag in US-Dollar an, so wie OpenAI
sie meldet.

## Berichtsdimensionen

- **Konto** ist das Projekt. Ausgaben außerhalb eines Projekts erscheinen unter der Identität der
  Verbindung.
- **Dienst** ist `OpenAI`.
- **SKU** ist die Position von OpenAI, etwa `gpt-4.1-mini-2025-04-14, input`, unverändert: OpenAI
  dokumentiert ihr Format nicht, daher teilt Costfluent sie nicht in Modell und Vorgang.
- Das Rechnungskonto ist die Identität der Verbindung, und der Abrechnungszeitraum ist der
  Kalendermonat.

## Aktualisieren oder trennen

### Nach dem Verbinden

Der Tab **Verwalten** listet die Verbindung mit ihrer **Organisations-ID**: der Organisation, die
OpenAI genannt hat, oder `key:` und dem Fingerabdruck des Schlüssels. Über das Zahnrad daneben siehst
du, ob die Kosten noch lesbar sind, welche Workspaces die Verbindung speist und welche Monate
importiert wurden. **Prüfungen ausführen** führt die Prüfungen auf Anfrage erneut aus.

### Zugriff rotieren oder entfernen

Ist die Verbindung an der Organisation erkannt, wähle auf der Verbindungsseite **Zugangsdaten
aktualisieren** und füge einen neuen Admin-Schlüssel derselben Organisation ein; widerrufe danach den
alten Schlüssel. Ist sie am Fingerabdruck des Schlüssels erkannt, ist ein neuer Schlüssel eine neue
Identität und wird abgelehnt: Entferne die Verbindung und verbinde stattdessen den neuen Schlüssel.

Um die Verbindung aufzugeben, entferne sie in Costfluent und widerrufe ihren Schlüssel auf der
OpenAI-Plattform. Das Entfernen löscht die von ihr importierten Kosten
([Verbindung entfernen](/de/connect/manage-connections#verbindung-entfernen)).

## Fehlerbehebung

- **OpenAI refused this key.** Die Meldung erscheint auch in der deutschen Oberfläche auf Englisch.
  Der Schlüssel ist kein Admin-Schlüssel oder wurde widerrufen. Ein Organization Owner legt
  Admin-Schlüssel in den Einstellungen der Organisation an.
- **OpenAI has no costs endpoint for this key's organization.** OpenAI hat geantwortet, dass es die
  Costs API für die Organisation nicht gibt. Prüfe, ob der Schlüssel zu einer Organisation mit
  API-Nutzung gehört.
- **This key belongs to another organization.** Erscheint beim Aktualisieren der Zugangsdaten.
  Verbinde diese Organisation oder diesen Schlüssel als neue Verbindung.