Api: Eigene Medien übergeben

Übergeben Sie Morphic eigene Bilder, Videos, Audiodateien und Dokumente per URL, in jedem Feld, das Medien entgegennimmt.

Jedes Feld, das Medien entgegennimmt (image_asset_id, reference_video_asset_ids, asset_id und jedes andere *_asset_id oder *_asset_ids), akzeptiert entweder eine Asset-ID aus Ihrer Bibliothek oder eine öffentliche HTTPS-URL der Datei. Beides lässt sich in einem Aufruf frei kombinieren. Einen separaten Upload-Schritt gibt es nicht.

curl -s https://mcp.morphic.com/v1/direct/tools/edit_image \
  -H "Authorization: Bearer $MORPHIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "Put the bike on a beach at sunset", "image_asset_ids": ["https://cdn.example.com/products/bike.jpg"], "project_id": "01928f4e-…"}}'

Bevor das Tool läuft, wird jede URL abgerufen und als hochgeladenes Asset kostenlos zu project_id hinzugefügt. Das Tool verarbeitet es dann wie jedes andere Asset. Eine URL erfordert die Berechtigung assets:write, und jede einzelne URL zählt als ein Aufruf gegen das Kontingent für kostenlose Aufrufe.

Die URL muss HTTPS auf einem öffentlichen Host sein und die Datei selbst ausliefern, keine Webseite.
Für eine Datei in Ihrem eigenen Speicher übergeben Sie eine signierte URL (ein vorsigniertes S3-GET, eine signierte GCS-URL). Sie muss gültig bleiben, bis der Aufruf antwortet.
Bilder, Videos, Audiodateien und Dokumente (.pdf, .txt, .md, .srt) werden akzeptiert. Die Bytes werden geprüft, der Dateiendung wird also nie vertraut.
Eine Mediendatei darf bis zu 100 MB groß sein, oder das Upload-Limit Ihres Plans, wenn dieses niedriger ist, und muss innerhalb von 25 Sekunden eintreffen.
Eine URL, die in einem Aufruf zweimal vorkommt, wird einmal abgerufen. Ein späterer Aufruf ruft sie erneut ab; um eine Datei ohne erneuten Abruf wiederzuverwenden, übergeben Sie die Asset-ID, die list_assets für sie anzeigt.
Die Eingabe des Aufrufs wird gegen das Schema des Tools geprüft, bevor eine URL abgerufen wird. Ein fehlerhafter Aufruf ergibt 400 invalid_request und ruft nichts ab.
Eine URL, die nicht abgerufen werden kann oder nicht akzeptiert wird, ergibt 422 tool_refused mit dem betroffenen Feld, zum Beispiel input.image_asset_ids[0]: The URL must use https. Nichts wird gestartet oder berechnet. Eine bereits hinzugefügte Datei bleibt im Projekt, so wie wenn das Tool selbst den Aufruf danach ablehnt.
analyze_video und analyze_audio nehmen project_id nur dafür entgegen: Senden Sie es, wenn ein Medienfeld eine URL enthält.
Auch Schritte von plan_media akzeptieren URLs; jede wird zur project_id ihres Schritts hinzugefügt, sodass ein Angebot diese Dateien Ihrer Bibliothek hinzufügt. Übergeben Sie den Schritten, die Sie ausführen, die Asset-IDs, die list_assets dann anzeigt, statt der URLs, damit jede Datei nur einmal abgerufen wird.

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.