Authentifizierung
Erstellen Sie in Studio einen Schlüssel für die Direct API, wählen Sie seine Berechtigungen und Credit-Limits und senden Sie ihn mit jeder Anfrage.
Jede Anfrage enthält einen API-Schlüssel der Organisation als Bearer-Token.
Authorization: Bearer mor_live_9f2c…Ein Schlüssel gehört der Organisation, nicht der Person, die ihn erstellt hat. Jeder Admin der Organisation kann ihn sehen und widerrufen, und er funktioniert weiter, wenn die Person, die ihn erstellt hat, das Team verlässt. Er funktioniert nicht mehr, wenn er widerrufen wird, wenn er abläuft, wenn das Konto der erstellenden Person gesperrt wird oder wenn Morphic die Direct API für die Organisation abschaltet.
Einen Schlüssel erstellen
Die Berechtigungen der Direct API erscheinen erst, wenn Morphic die Direct API für Ihre Organisation freigeschaltet hat. Siehe Zugang erhalten.
- Öffnen Sie in Morphic Studio das Organisations-Dropdown (das Morphic-Logo oben links) und wählen Sie Einstellungen.
- Klicken Sie in der linken Seitenleiste auf API-Schlüssel. Nur Admins sehen diesen Tab.
- Klicken Sie auf Neuer Schlüssel.
- Füllen Sie das Feld Name aus, wählen Sie unter Berechtigungen, was der Schlüssel benötigt, und legen Sie, falls er nicht unbegrenzt gelten soll, unter Läuft ab fest, wann er abläuft.
- Legen Sie unter Credit-Limits fest, wie viel der Schlüssel insgesamt jemals ausgeben darf, und optional ein Tages- und ein Monatslimit.
- Aktivieren Sie „Ich stimme den Nutzungsbedingungen von Morphic einschließlich des Abschnitts zur Entwickler-API zu“. Damit akzeptieren Sie die Nutzungsbedingungen für die Organisation.
- Klicken Sie auf Schlüssel erstellen und kopieren Sie das Secret anschließend in Ihren Secret-Manager. Es wird nur einmal angezeigt.
Wer das Secret besitzt, kann die Credits Ihrer Organisation bis zu den Limits des Schlüssels ausgeben. Legen Sie einen Schlüssel niemals in einem Browser, einer mobilen App oder einem öffentlichen Repository ab.
Schlüsselformat
mor_live_<64 hex characters>Das Präfix zeigt Ihnen und Secret-Scannern, für welche Bereitstellung der Schlüssel bestimmt ist.
Berechtigungen
Ein Schlüssel erreicht nur die Tools, die seine Berechtigungen zulassen. Wählen Sie die kleinstmögliche Auswahl.
| Berechtigung | Bezeichnung in Studio | Erlaubt |
|---|---|---|
projects:read | Projekte und ihre Dateien lesen | Projekte, Workflows und Compose-Timelines auflisten |
assets:read | Assets finden und lesen | die Bibliothek auflisten, Generierungen und ihren Status lesen, Charaktere |
assets:write | Assets hochladen und bearbeiten | Medien per URL übergeben, Compose-Timelines erstellen |
generations:write | Bilder, Videos und Audio generieren (verbraucht Credits) | jedes Tool, das Medien startet, bearbeitet oder analysiert |
Ein Aufruf eines Tools außerhalb der Berechtigungen des Schlüssels antwortet mit 403 insufficient_scope und nennt die fehlende Berechtigung in data.required_scopes. Endpunkte und Tools, die keine Berechtigung benötigen, etwa list_voices und /me, stehen jedem Schlüssel offen. Der Tool-Katalog listet die Berechtigung auf, die jedes Tool benötigt.
Credit-Limits
Jeder Schlüssel hat Ausgabengrenzen, die bei seiner Erstellung festgelegt werden. Ein Admin kann sie später mit Limits bearbeiten ändern.
| Limit | Erforderlich | Zeitraum |
|---|---|---|
total_credit_limit | ja | die gesamte Lebensdauer des Schlüssels |
monthly_credit_limit | nein | Kalendermonat, UTC |
daily_credit_limit | nein | Kalendertag, UTC |
- Ein kostenpflichtiger Aufruf, der den Schlüssel über eines der Limits bringen würde, wird mit
402 api_key_credit_limit_reachedabgelehnt, bevor etwas startet;data.periodgibt an, welches Limit betroffen ist. - Zusätzlich gilt das Guthaben der Organisation: Ein Aufruf, den sie nicht bezahlen kann, wird mit
402 insufficient_creditsabgelehnt. GET /v1/direct/meliefert die Limits des Schlüssels und seine aktuellen Ausgaben. Siehe Credits und Nutzung.
Einen Schlüssel rotieren
- Erstellen Sie den neuen Schlüssel.
- Stellen Sie ihn bereit.
- Widerrufen Sie den alten Schlüssel mit Schlüssel widerrufen.
Eine Organisation kann bis zu 10 aktive Schlüssel haben, sodass eine Rotation nie eine Lücke erfordert.
Wenn Sie Probleme haben oder Fragen haben, können Sie sich gerne an uns wenden. Wir helfen Ihnen gerne. Schreiben Sie uns an support@morphic.com.
Direct API
Erzeugen, bearbeiten und verwalten Sie Bilder, Videos und Audio in Morphic direkt aus Ihrem eigenen Backend über HTTPS.
Ein Tool aufrufen
Rufen Sie jedes Tool der Direct API mit derselben Anfrageform auf, lesen Sie Ergebnis und Abrechnung und wiederholen Sie kostenpflichtige Aufrufe sicher mit einem Idempotency-Key.