Worlds
Upload von Medien-Assets vorbereiten
Erstellt ein Upload-Ziel für World Labs-Medien-Assets
Erstellen Sie einen World Labs-Medien-Asset-Datensatz und erhalten Sie eine Upload-URL für ein Bild oder Video. Laden Sie die Binärdatei auf upload_info.upload_url hoch und verweisen Sie anschließend aus world_prompt mit source: "media_asset" auf die zurückgegebene media_asset.media_asset_id.
Das Asset ist nur in dem Workspace verfügbar, in dem es erstellt wurde.
{
"model": "marble-1.1",
"world_prompt": {
"type": "image",
"image_prompt": { "source": "media_asset", "media_asset_id": "<media_asset.media_asset_id>" }
}
}Senden Sie diesen Body an Welt erstellen. Eine media_asset_id, die zu einem anderen Workspace gehört, gibt 403 media_asset_not_owned zurück; eine unbekannte gibt 404 media_asset_not_found zurück.
Request-Body
Ursprünglicher Dateiname, bis zu 64 Zeichen, zum Beispiel reference.png.
Medientyp: image oder video.
Optionale Dateiendung wie png, jpg oder mp4.
Benutzerdefinierte Metadaten, die mit dem Asset gespeichert werden.
Antwort
Vorbereitete Medien-Asset-Metadaten: media_asset_id, file_name, kind, extension, metadata, created_at und updated_at.
Signierte URL für das Hochladen der Datei.
HTTP-Methode, die beim Hochladen der Binärdatei auf upload_info.upload_url verwendet werden soll, sofern zurückgegeben.
Header, die beim binären Upload enthalten sein müssen, sofern zurückgegeben.
Anfrage
curl -X POST "https://api.tokenlab.sh/v1/worlds/media-assets/prepare-upload" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"file_name": "reference.png",
"kind": "image",
"extension": "png"
}'{ "media_asset": { "created_at": "2019-08-24T14:15:22Z", "file_name": "string", "kind": "image", "media_asset_id": "string", "extension": "string", "metadata": {}, "updated_at": "2019-08-24T14:15:22Z" }, "upload_info": { "upload_method": "string", "upload_url": "http://example.com", "curl_example": "string", "required_headers": { "property1": "string", "property2": "string" } }}Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Anfragekörper
application/json
Antwort
application/json
application/json