Worlds
미디어 에셋 업로드 준비
World Labs 미디어 에셋 업로드 대상을 생성합니다
World Labs 미디어 에셋 레코드를 생성하고 이미지 또는 비디오에 대한 업로드 URL을 수신합니다. 바이너리 파일을 upload_info.upload_url로 업로드한 후, 반환된 media_asset.media_asset_id를 source: "media_asset"과 함께 world_prompt에서 참조하세요.
해당 에셋은 이를 생성한 Workspace에서만 사용할 수 있습니다.
{
"model": "marble-1.1",
"world_prompt": {
"type": "image",
"image_prompt": { "source": "media_asset", "media_asset_id": "<media_asset.media_asset_id>" }
}
}이 본문을 월드 생성으로 전송하세요. 다른 Workspace에 속한 media_asset_id는 403 media_asset_not_owned를 반환하며, 알 수 없는 ID는 404 media_asset_not_found를 반환합니다.
요청 본문
원본 파일 이름이며, 최대 64자입니다. 예: reference.png.
미디어 유형: image 또는 video.
png, jpg, mp4와 같은 선택적 확장자입니다.
에셋과 함께 저장되는 커스텀 메타데이터입니다.
응답
준비된 미디어 에셋 메타데이터: media_asset_id, file_name, kind, extension, metadata, created_at, updated_at.
파일 업로드를 위한 서명된 URL입니다.
반환된 경우, 바이너리 파일을 upload_info.upload_url로 업로드할 때 사용할 HTTP 메서드입니다.
반환된 경우, 바이너리 업로드 시 포함해야 하는 헤더입니다.
요청
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" } }}인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
요청 본문
application/json
응답
application/json
application/json