Gunakan SearchMedia untuk kueri aset media - Intelligent Media Services

Mengembalikan aset media yang sesuai dengan parameter yang ditentukan.

Deskripsi operasi

Jika Anda memiliki pertanyaan tentang fitur Pencarian Aset Media Cerdas dari Intelligent Media Management (IMM), cari ID grup DingTalk 30415005038 untuk bergabung ke grup Tanya Jawab Pencarian Multimodal kami dan mendapatkan bantuan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ice:SearchMedia

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Match	string	No	Kondisi filter untuk pencarian.	title = '中国' and utcCreate = ['1693367158561','1693367158562']
SortBy	string	No	Bidang pengurutan dan urutan pengurutan. Pisahkan beberapa kriteria pengurutan dengan koma (,).	utcCreate:Desc
PageNo	integer	No	Nomor halaman yang akan dikembalikan. Nilai default adalah 1.	1
PageSize	integer	No	Jumlah hasil per halaman. Nilai default adalah 10, dan nilai maksimum adalah 50.	20
EntityId	string	No	ID entitas.	2d3bf1e35a1e42b5ab338d701efa****
ScrollToken	string	No	Token scroll untuk paginasi dalam. Ini adalah string sepanjang 32 karakter. Parameter ini tidak diperlukan untuk permintaan pencarian pertama. Jika pencarian berhasil, respons akan menyertakan `ScrollToken` untuk menandai posisi saat ini. Gunakan token ini pada permintaan berikutnya untuk mengambil halaman hasil berikutnya. Parameter ini wajib digunakan untuk mengiterasi seluruh hasil yang sesuai. Untuk performa optimal, gunakan parameter ini ketika nilai `PageNo` melebihi 200. Anda hanya dapat melakukan scroll maju, hingga maksimal 1.000 aset media.	F8C4F642184DBDA5D93907A70AAE****
SearchLibName	string	No	Nama pustaka pencarian.	test-1
CustomFilters	string	No	Filter kustom, ditentukan sebagai string JSON. Mendukung bidang integer intField1 dan bidang string strField1 serta strField2. Gunakan hanya satu jenis pencocokan per bidang. Kondisi pada bidang yang berbeda digabungkan dengan logika AND. Pencocokan eksak: `{"intField1":12,"strField1":"abc"}` Pencocokan multi-nilai: `{"intField1":[12,13],"strField1":["abc","cd"]}` Pencocokan rentang: `{"intField1":{"gte":12,"lte":13}}`	{"intField1":{"gte":12,"lte":13},"strField2":["cd","de"],"strField1":"abc"}

Elemen respons

Element	Type	Description	Example
	object	Skema respons.
RequestId	string	ID permintaan.	6F61C357-ACC0-57FB-876E-D5879533****
Success	string	Menunjukkan apakah permintaan berhasil.	True
Code	string	Kode respons.	200
MediaInfoList	array<object>	Kumpulan aset media yang sesuai dengan kriteria.
	array<object>	Satu aset media.
MediaId	string	ID aset media.	3b187b3620c8490886cfc2a9578c****
MediaBasicInfo	object	Informasi dasar mengenai aset media.
MediaId	string	ID aset media.	132bd600fc3c71ec99476732a78f****
InputURL	string	URL sumber aset media.	oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf8498165024814****
MediaType	string	Jenis aset media.	video
BusinessType	string	Jenis bisnis aset media.	opening
Source	string	Sumber aset media.	oss
Title	string	Judul aset media.	智能横屏转竖屏
Description	string	Deskripsi aset media.	对这个视频进行转码处理了
Category	string	Kategori aset media.	image
MediaTags	string	Tag yang ditetapkan untuk aset media. Beberapa tag dipisahkan dengan koma.	tags,tags2
CoverURL	string	URL gambar sampul.	https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f2****_large_cover_url.jpg
UserData	string	Data pengguna kustom.	userData
Snapshots	string	Informasi snapshot dalam format JSON.	[{"bucket":"example-bucket","count":"3","iceJobId":"****f48f0e4154976b2b8c45**","location":"oss-cn-beijing","snapshotRegular":"example.jpg","templateId":"**e6a6440b29eb60bd7c****"}]
Status	string	Status aset media.	Normal
TranscodeStatus	string	Status transkoding aset media.	Init
CreateTime	string	Waktu pembuatan aset media.	2020-12-01T19:48Z
ModifiedTime	string	Waktu terakhir aset media dimodifikasi.	2020-12-01T19:48Z
DeletedTime	string	Waktu penghapusan aset media.	2020-12-01T19:48Z
SpriteImages	string	Informasi Sprite Image dalam format JSON.	[{"bucket":"example-bucket","count":"32","iceJobId":"****83ec44d58b2069def2e**","location":"oss-cn-shanghai","snapshotRegular":"example/example-{Count}.jpg","spriteRegular":"example/example-{TileCount}.jpg","templateId":"**e438b14ff39293eaec25****","tileCount":"1"}]
CateId	integer	ID kategori.	44
Biz	string	Bisnis tempat aset media tersebut berada.	IMS
UploadSource	string	Sumber unggahan.	general
CateName	string	Nama kategori.	子分类1
ReferenceId	string	ID kustom unik untuk pengguna. Panjangnya harus antara 6 hingga 64 karakter dan hanya boleh berisi huruf kecil, huruf besar, angka, tanda hubung (-), dan garis bawah (_).	123-123
Namespace	string	Namespace.	name-1
VisionDescription	string	Deskripsi konten media yang dihasilkan oleh visi komputer.	足球进球
StreamStatus	string	Status aliran.	Active
FileInfoList	array<object>	Daftar informasi file.
	array<object>	Objek informasi file.
FileBasicInfo	object	Informasi dasar mengenai file, seperti durasi dan ukuran.
FileName	string	Nama file.	164265080291300080527050.wav
FileStatus	string	Status file.	Normal
FileType	string	Jenis file.	source_file
FileSize	string	Ukuran file dalam byte.	324784
FileUrl	string	URL Object Storage Service (OSS) file tersebut.	https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-1818098****.mp4
Region	string	Wilayah tempat file disimpan.	cn-beijing
FormatName	string	Format kontainer file.	mov,mp4,m4a,3gp,3g2,mj2
Duration	string	Durasi file.	60.00000
Bitrate	string	Bitrate file.	1912.13
Width	string	Lebar video dalam piksel.	1920
Height	string	Tinggi video dalam piksel.	480
CreateTime	string	Waktu pembuatan file.	2022-05-30T02:02:17Z
ModifiedTime	string	Waktu terakhir file dimodifikasi.	2021-12-10T12:19Z
ImagesInput	string	Informasi mengenai set gambar.	{}
AiData	object	Data AI detail.
AiLabelInfo	array<object>	Daftar informasi label AI.
	array<object>	Objek label AI.
FaceId	string	ID wajah yang dikenali.	5FE19530C7A422197535FE74F5DB****
LabelType	string	Jenis label.	物体
Source	string	Sumber data AI.	vision
Category	string	Kategori label.	交通工具
LabelName	string	Nama entitas.	车
LabelId	string	ID entitas.	10310250338
Occurrences	array<object>	Daftar klip tempat entitas muncul.
	array<object>	Objek klip.
Score	number	Skor kepercayaan untuk hasil pengenalan.	0.75287705
Image	string	Gambar optimal wajah yang dikenali, dikodekan dalam Base64.	99C64F6287
TableBatchSeqId	string	ID urutan tabel vektor.	85010D1
clipId	string	ID klip.	5FE19530C7A422197535FE74F5DB****
From	number	Waktu mulai klip.	1.4
To	number	Waktu akhir klip.	2.5
FinegrainName	string	Nama detail halus entitas.	车
FinegrainId	string	ID detail halus entitas.	10310250338
Content	string	Konten teks.	皮皮
Tracks	array<object>	Rangkaian track yang merepresentasikan entitas dalam klip.
	object	Titik data track.
Size	number	Ukuran Kotak pembatas.	50.2
Position	string	Koordinat Kotak pembatas.	468.0;67.0;615.0;267.0
Timestamp	number	Timestamp titik data track.	1.4
AsrInfo	array<object>	Daftar hasil Automatic Speech Recognition (ASR).
	object	Objek hasil ASR.
From	number	Waktu mulai klip.	1.4
To	number	Waktu akhir klip.	2.5
ClipId	string	ID klip.	5FE19530C7A422197535FE74F5DB****
Content	string	Konten teks hasil transkripsi.	我是皮皮
Timestamp	number	Timestamp klip.	1.4
OcrInfo	array<object>	Daftar hasil Optical Character Recognition (OCR).
	object	Objek hasil OCR.
From	number	Waktu mulai klip.	1.4
To	number	Waktu akhir klip.	2.5
ClipId	string	ID klip.	5FE19530C7A422197535FE74F5DB****
Content	string	Konten teks hasil pengenalan.	我是皮皮
Timestamp	number	Timestamp klip.	1.4
AiRoughData	object	Rangkuman data pemrosesan AI.
SaveType	string	Jenis penyimpanan data AI.	TEXT
Status	string	Status penyimpanan data AI.	SaveSuccess
AiJobId	string	ID pekerjaan AI.	cd35b0b0025f71edbfcb472190a9****
Result	string	URL file hasil AI mentah.	http://xxxx.json
AiCategory	string	Kategori AI yang diterapkan pada aset media.	视频AI分类
IndexStatusList	array<object>	Daftar status pengindeksan untuk berbagai jenis indeks.
	object	Objek status indeks.
IndexType	string	Jenis indeks. Nilai yang valid: `mm`: Large Language Model (LLM). `face`: Face. `aiLabel`: AI Label.	mm
IndexStatus	string	Status indeks. Nilai yang valid: `Running`: Indeks sedang dibuat. `Fail`: Pembuatan indeks gagal. `Success`: Indeks berhasil dibuat.	Success
CustomFields	string	Bidang kustom untuk pemfilteran, disediakan sebagai string JSON.	{\"intField1\":12,\"strField1\":\"abc\"}
ScrollToken	string	Token yang digunakan untuk mengambil halaman hasil berikutnya.	F8C4F642184DBDA5D93907A70AAE****
Total	integer	Jumlah total aset media yang sesuai dengan kriteria pencarian.	163

Contoh

Respons sukses

JSONformat

{
  "RequestId": "6F61C357-ACC0-57FB-876E-D5879533****",
  "Success": "True",
  "Code": "200",
  "MediaInfoList": [
    {
      "MediaId": "3b187b3620c8490886cfc2a9578c****",
      "MediaBasicInfo": {
        "MediaId": "132bd600fc3c71ec99476732a78f****",
        "InputURL": "oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf8498165024814****",
        "MediaType": "video",
        "BusinessType": "opening",
        "Source": "oss",
        "Title": "智能横屏转竖屏",
        "Description": "对这个视频进行转码处理了",
        "Category": "image",
        "MediaTags": "tags,tags2\n",
        "CoverURL": "https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f2****_large_cover_url.jpg",
        "UserData": "userData",
        "Snapshots": "[{\"bucket\":\"example-bucket\",\"count\":\"3\",\"iceJobId\":\"******f48f0e4154976b2b8c45******\",\"location\":\"oss-cn-beijing\",\"snapshotRegular\":\"example.jpg\",\"templateId\":\"******e6a6440b29eb60bd7c******\"}]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-01T19:48Z",
        "ModifiedTime": "2020-12-01T19:48Z\n",
        "DeletedTime": "2020-12-01T19:48Z\n",
        "SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]",
        "CateId": 44,
        "Biz": "IMS",
        "UploadSource": "general",
        "CateName": "子分类1",
        "ReferenceId": "123-123",
        "Namespace": "name-1",
        "VisionDescription": "足球进球",
        "StreamStatus": "Active"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "164265080291300080527050.wav",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "324784",
            "FileUrl": "https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-1818098****.mp4",
            "Region": "cn-beijing",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "60.00000\n",
            "Bitrate": "1912.13\n",
            "Width": "1920",
            "Height": "480",
            "CreateTime": "2022-05-30T02:02:17Z",
            "ModifiedTime": "2021-12-10T12:19Z",
            "ImagesInput": "{}"
          }
        }
      ],
      "AiData": {
        "AiLabelInfo": [
          {
            "FaceId": "5FE19530C7A422197535FE74F5DB****",
            "LabelType": "物体",
            "Source": "vision",
            "Category": "交通工具",
            "LabelName": "车",
            "LabelId": "10310250338",
            "Occurrences": [
              {
                "Score": 0.75287705,
                "Image": "99C64F6287",
                "TableBatchSeqId": "85010D1",
                "clipId": "5FE19530C7A422197535FE74F5DB****",
                "From": 1.4,
                "To": 2.5,
                "FinegrainName": "车",
                "FinegrainId": "10310250338",
                "Content": "皮皮",
                "Tracks": [
                  {
                    "Size": 50.2,
                    "Position": "468.0;67.0;615.0;267.0",
                    "Timestamp": 1.4
                  }
                ]
              }
            ]
          }
        ],
        "AsrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****",
            "Content": "我是皮皮",
            "Timestamp": 1.4
          }
        ],
        "OcrInfo": [
          {
            "From": 1.4,
            "To": 2.5,
            "ClipId": "5FE19530C7A422197535FE74F5DB****",
            "Content": "我是皮皮",
            "Timestamp": 1.4
          }
        ]
      },
      "AiRoughData": {
        "SaveType": "TEXT",
        "Status": "SaveSuccess",
        "AiJobId": "cd35b0b0025f71edbfcb472190a9****",
        "Result": "http://xxxx.json",
        "AiCategory": "视频AI分类"
      },
      "IndexStatusList": [
        {
          "IndexType": "mm",
          "IndexStatus": "Success"
        }
      ],
      "CustomFields": "{\\\"intField1\\\":12,\\\"strField1\\\":\\\"abc\\\"}"
    }
  ],
  "ScrollToken": "F8C4F642184DBDA5D93907A70AAE****",
  "Total": 163
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.