Standar API dan SDK siap pakai dalam berbagai bahasa
Spesifikasi OpenAPI produk ini (imm/2020-09-30) mematuhi standar RPC. Alibaba Cloud menyediakan SDK siap pakai untuk berbagai bahasa pemrograman populer guna mengabstraksi kompleksitas tingkat rendah seperti request signing. Hal ini memungkinkan developer untuk memanggil API menggunakan sintaks khusus tanpa perlu menangani detail HTTP secara langsung.
Signature kustom
Jika SDK tidak mendukung kebutuhan spesifik Anda, seperti signature kustom, Anda harus menandatangani request secara manual menggunakan signature mechanism. Perhatikan bahwa proses penandatanganan manual memerlukan upaya yang signifikan (estimasi 5 hari kerja). Untuk mendapatkan dukungan, bergabunglah dengan grup DingTalk kami (ID: 147535001692).
Sebelum Anda mulai
Akun Alibaba Cloud memiliki hak administratif penuh. Jika pasangan AccessKey dikompromikan, semua resource terkait dapat terekspos terhadap akses tidak sah, sehingga menimbulkan risiko keamanan yang signifikan. Buat Resource Access Management (RAM) user dengan akses khusus API dan gunakan kebijakan RAM untuk menerapkan principle of least privilege (PoLP). Gunakan akun Alibaba Cloud hanya jika benar-benar diperlukan.
Untuk memanggil API secara aman, konfigurasikan hal berikut:
Akun RAM user
Pasangan AccessKey untuk akun tersebut
Manajemen metadata
|
API |
Judul |
Deskripsi |
| Pengindeksan metadata | Pengindeksan metadata | |
| IndexFileMeta | Mengindeks metadata file | Memproses file input untuk tugas seperti pengenalan label, deteksi wajah, dan deteksi lokasi. Mengindeks metadata file yang diekstrak agar Anda dapat melakukan pengambilan data yang beragam dalam sebuah set data. |
| BatchIndexFileMeta | Indeks metadata file secara batch | Mengindeks metadata file secara batch. Melakukan pemrosesan data pada file input, seperti pengenalan tag, deteksi wajah, dan deteksi lokasi, serta mengindeks metadata file ke dalam dataset untuk mendukung pengambilan data yang beragam. |
| UpdateFileMeta | Perbarui metadata file | Memperbarui sebagian metadata file yang telah diindeks dalam dataset. |
| BatchUpdateFileMeta | Pembaruan Batch Metadata File | Memperbarui sebagian metadata file terindeks dalam set data secara batch. |
| GetFileMeta | Mengkueri Metadata File | Mengkueri metadata file yang telah diindeks dalam set data. |
| BatchGetFileMeta | Pengambilan Metadata File Secara Batch | Mengambil metadata file terindeks dalam set data secara batch. |
| DeleteFileMeta | DeleteFileMeta | Menghapus metadata file dari set data. |
| BatchDeleteFileMeta | Hapus Metadata File Secara Batch | Menghapus metadata file dari set data secara batch. |
| Kueri dan statistik | Kueri dan statistik | |
| SimpleQuery | SimpleQuery | Mengkueri dan mengagregasi file dalam dataset. Mendukung ekspresi hubungan logis. |
| SemanticQuery | Kueri Bahasa Alami | Melakukan pencarian kueri berbasis semantik pada metadata dalam set data menggunakan bahasa alami. |
| FuzzyQuery | Pencocokan Kabur | Mengkueri metadata file yang diekstrak (termasuk bidang seperti nama file, tag, path, dan tag kustom). Jika nilai bidang apa pun dalam metadata file cocok dengan string yang ditentukan, metadata file tersebut akan dikembalikan. |
| Manajemen cerdas | Manajemen cerdas | |
| Pengelompokan wajah | Pengelompokan wajah | |
| CreateFigureClusteringTask | Membuat Tugas Pengelompokan Figur | Membuat tugas pengelompokan figur. Dengan menggunakan algoritme cerdas, wajah orang yang berbeda dalam gambar yang telah Anda indeks ke set data dikelompokkan dan diklusterkan. |
| CreateFigureClustersMergingTask | Menggabungkan Kluster Figur | Menggabungkan dua atau lebih kelompok Pengelompokan figur menjadi satu kelompok Pengelompokan figur. |
| GetFigureCluster | Mengambil informasi pengelompokan wajah | Mengambil informasi dasar tentang kluster wajah, termasuk pengatur waktu pembuatan, jumlah foto, dan sampul kluster. |
| QueryFigureClusters | Mengkueri kluster figur | Melakukan kueri bersyarat pada Pengelompokan Kluster dan informasi terkait. |
| BatchGetFigureCluster | Dapatkan Kluster Figur Secara Batch | Mengambil kluster figur beserta informasinya secara batch. |
| UpdateFigureCluster | Memperbarui kluster figur | Memperbarui informasi kelompok pengelompokan wajah, seperti nama kelompok dan tag. |
| SearchImageFigureCluster | Mengkueri kluster wajah dari semua wajah dalam sebuah gambar | Mengkueri daftar kluster figur dari semua wajah dalam gambar yang ditentukan. Setiap kluster figur berisi informasi seperti kotak pembatas wajah dan tingkat kemiripan. |
| CreateFacesSearchingTask | Membuat tugas pencarian gambar wajah serupa | Mencari N image teratas yang paling mirip dengan image atau ID wajah yang ditentukan di set media, lalu mengembalikan ID wajah dan kotak pembatas yang sesuai. Hasil dikembalikan dalam urutan menurun berdasarkan kemiripan. |
| Pengelompokan spasial-temporal | Pengelompokan spasial-temporal | |
| CreateLocationDateClusteringTask | Membuat tugas pengelompokan spatiotemporal | Fitur pengelompokan spatiotemporal. Anda dapat mengkategorikan file seperti gambar dan video yang telah diindeks ke dalam dataset dan yang membawa informasi waktu pengambilan dan lokasi berdasarkan waktu dan lokasi geografis. Kategori-kategori ini dapat dipahami sebagai konten yang diambil selama perjalanan pengguna (berdekatan dalam waktu dan lokasi), atau sebagai konten yang diambil di lokasi tempat tinggal dan kerja pengguna yang berbeda. Dengan memperoleh dan menganalisis lokasi serta rentang waktu dari kategori-kategori ini, Anda dapat memberikan pengguna kemampuan seperti pengkategorian file media, kurasi, dan pembuatan cerita foto dan video. |
| QueryLocationDateClusters | Mengkueri klaster spasiotemporal | Mengkueri daftar informasi klaster spasiotemporal. Mendukung beberapa kondisi. Untuk informasi selengkapnya, lihat parameter permintaan. |
| UpdateLocationDateCluster | Memperbarui kluster spasial-temporal | Memperbarui informasi kluster spasial-temporal. |
| DeleteLocationDateCluster | Menghapus Kelompok Kluster Spasiotemporal | Menghapus kluster spasiotemporal. |
| Cerita | Cerita | |
| QueryStories | QueryStories | Melakukan kueri cerita beserta informasinya berdasarkan kondisi yang ditentukan. |
| Pengelompokan gambar | Pengelompokan gambar | |
| CreateSimilarImageClusteringTask | Membuat tugas pengelompokan gambar serupa | Fitur Kluster gambar serupa dapat membuat Kluster gambar yang telah Anda indeks ke dalam set data berdasarkan kesamaan. Fitur ini digunakan dalam skenario seperti deduplikasi dan pemilihan gambar. Misalnya, Anda dapat menggunakan fitur ini untuk menyaring gambar yang diambil secara berurutan dalam album. |
| QuerySimilarImageClusters | Query similar image clusters | Mengkueri daftar kluster image serupa. |
| Pengikatan data | Pengikatan data | |
| CreateBinding | Membuat tugas binding | Membuat binding antara sebuah dataset dan bucket Object Storage Service (OSS). Setelah binding dibuat, file lengkap dan inkremental dalam bucket akan secara otomatis disinkronkan dan diindeks. |
| GetBinding | Mengkueri Informasi Pengikatan | Mengkueri detail hubungan pengikatan antara set data tertentu dan Bucket OSS. |
| ListBindings | Mengkueri Daftar Binding | Mengkueri daftar binding antara set data dan bucket Object Storage Service (OSS). |
| DeleteBinding | DeleteBinding | Menghapus task pengikatan antara dataset dan bucket Object Storage Service (OSS). |
| AttachOSSBucket | Lampirkan bucket OSS | Mengikat bucket OSS ke proyek IMM sehingga Anda dapat menggunakan kemampuan pemrosesan data IMM melalui metode OSS x-oss-process. |
| DetachOSSBucket | Melepas Bucket OSS | Melepaskan proyek dari bucket OSS. |
| GetOSSBucketAttachment | Mendapatkan Informasi Pengikatan Bucket OSS | Mengambil nama proyek dari proyek yang terikat pada bucket OSS tertentu di wilayah yang sama. |
Pemrosesan gambar
|
API |
Judul |
Deskripsi |
| EncodeBlindWatermark | Menambahkan Blind Watermark ke Image | Menyematkan informasi teks tertentu ke dalam image sebagai Watermark yang tidak terlihat. Karena Watermark ini tidak terlihat secara visual, Watermark tidak memengaruhi estetika image atau penyampaian informasi asli. Watermark dapat diekstrak dengan memanggil operasi CreateDecodeBlindWatermarkTask. |
| CreateDecodeBlindWatermarkTask | Membuat tugas untuk mengekstrak watermark buta. | Mengekstrak watermark buta. |
| GetDecodeBlindWatermarkResult | Hasil tugas ekstraksi watermark buta | Mengambil hasil tugas yang mengekstrak watermark buta dari image. |
| DetectImageLabels | Mendeteksi Tag dalam Image | Mendeteksi tag scene, objek, dan event dalam sebuah image. Informasi scene mencakup kategori seperti lanskap alam, scene kehidupan sehari-hari, dan scene bencana. Informasi event mencakup kategori seperti acara bakat, aktivitas kantor, pertunjukan, dan aktivitas produksi. Informasi objek mencakup kategori seperti peralatan makan, elektronik, furnitur, dan kendaraan. Deteksi tag image saat ini mendukung lebih dari tiga puluh kategori dan ribuan tag. |
| DetectImageScore | Dapatkan Skor Image | Mengevaluasi kualitas visual image berdasarkan estetika subjektif, dengan mempertimbangkan berbagai faktor seperti komposisi, kecerahan, kontras, warna, dan kejernihan. Fitur ini mengembalikan skor kualitas image berkisar antara 0 hingga 1, di mana skor yang lebih tinggi menunjukkan kualitas visual image yang lebih tinggi. |
| DetectImageCodes | Mendeteksi kode QR image | Mendeteksi barcode dan kode QR pada image yang ditentukan. |
| DetectImageFaces | Mendeteksi wajah dan informasi wajah dalam gambar menggunakan model AI | Mendeteksi informasi batas wajah, informasi atribut, dan informasi kualitas dalam gambar yang ditentukan. Informasi batas (Boundary) meliputi: jarak koordinat Y titik puncak ke atas (Top), jarak koordinat X titik puncak ke kiri (Left), tinggi (Height), dan lebar (Width). Informasi atribut meliputi: usia (Age), simpangan baku usia (AgeSD), jenis kelamin (Gender), emosi (Emotion), apakah mulut terbuka (Mouth), apakah wajah berjanggut (Beard), apakah wajah memakai topi (Hat), apakah wajah memakai masker (Mask), apakah wajah memakai kacamata (Glasses), pose kepala (HeadPose), daya tarik wajah (Attractive), serta tingkat kepercayaan masing-masing atribut tersebut. Informasi kualitas meliputi: skor kualitas wajah (FaceQuality) dan ketajaman wajah (Sharpness). |
| DetectImageCropping | Mendeteksi wilayah pemotongan image optimal dengan menggunakan kemampuan model AI | Mendeteksi wilayah pemotongan yang optimal secara visual dalam image pada rasio aspek tertentu dengan menggunakan kemampuan model AI. |
| AddImageMosaic | Menambahkan mosaik gambar | Menambahkan pola mosaik, Gaussian blur, atau blok warna solid dalam berbagai bentuk ke satu atau beberapa area tertentu pada gambar, dan menyimpan gambar yang telah diproses ke alamat objek file OSS yang ditentukan. Fitur ini terutama digunakan untuk perlindungan privasi. |
| CreateImageToPDFTask | Membuat Tugas Image ke PDF | Mengonversi beberapa image menjadi satu file PDF dan menyimpan file tersebut ke alamat objek file OSS yang ditentukan. |
| CreateImageSplicingTask | Membuat Tugas Penggabungan Gambar | Menggabungkan beberapa gambar menjadi satu gambar berdasarkan aturan yang ditentukan dan menyimpan hasilnya ke alamat objek OSS yang ditentukan. |
| CompareImageFaces | Membandingkan Kemiripan Wajah Gambar | Membandingkan kemiripan wajah terbesar pada dua gambar. Wajah terbesar merujuk pada wajah dengan area terbesar di antara semua kotak pembatas wajah yang terdeteksi dalam gambar. |
| DetectImageBodies | Mendeteksi Tubuh Manusia dalam Gambar | Mendeteksi informasi tubuh manusia dalam gambar, termasuk skor kepercayaan dan bounding box. |
| DetectImageCars | Mendeteksi informasi kendaraan dalam gambar | Mendeteksi informasi batas kendaraan, informasi atribut kendaraan, dan informasi pelat nomor dalam gambar yang ditentukan. Informasi atribut kendaraan meliputi: warna kendaraan (CarColor) dan jenis kendaraan (CarType). Informasi pelat nomor meliputi: konten pengenalan pelat nomor (Content) dan informasi bingkai pelat nomor (Boundary). |
| DetectImageTexts | Pengenalan teks gambar | Mengenali konten teks dalam gambar sebagai teks yang dapat diedit. |
Pemrosesan media
|
API |
Judul |
Deskripsi |
| CreateMediaConvertTask | CreateMediaConvertTask | Membuat tugas transkoding media asinkron. Menyediakan kemampuan untuk transkoding media, penggabungan media, pengambilan frame video, konversi video ke gambar animasi, dan pemrosesan file media audio/video lainnya. |
| DetectMediaMeta | Mengambil metadata file media | Mengambil metadata file media, termasuk informasi format media dan informasi stream media. |
| CreateVideoLabelClassificationTask | Membuat tugas deteksi tag video | Mendeteksi informasi tag adegan, objek, dan peristiwa dalam konten video. Informasi adegan mencakup kategori seperti pemandangan alam, adegan kehidupan sehari-hari, dan adegan bencana. Informasi peristiwa mencakup kategori seperti pertunjukan bakat, aktivitas kantor, pertunjukan, dan aktivitas produksi. Informasi objek mencakup kategori seperti peralatan makan, produk elektronik, furnitur, dan kendaraan. Deteksi tag video saat ini mendukung lebih dari 30 kategori dan ribuan tag. |
| GetVideoLabelClassificationResult | Get video label detection task | Mengambil hasil tugas deteksi label video. |
| GenerateVideoPlaylist | Membuat daftar putar Transkoding just-in-time | Membuat daftar putar Transkoding just-in-time yang mengonversi file video menjadi file M3U8. Daftar putar dapat diputar segera setelah dibuat, dan Transkoding dilakukan sesuai permintaan berdasarkan progres pemutaran. Dibandingkan dengan Transkoding offline, hal ini secara signifikan mengurangi pengatur waktu tunggu Transkoding dan menurunkan biaya Transkoding serta penyimpanan secara substansial. |
| CreateHighlightTask | Membuat Tugas Kliping Sorotan Video | Membuat tugas sorotan video. Fitur ini berada dalam pratinjau undangan. |
Pemrosesan dokumen
|
API |
Judul |
Deskripsi |
| GenerateWebofficeToken | Mengambil kredensial weboffice | Mengambil kredensial Tampilan dan pengeditan untuk dokumen. |
| RefreshWebofficeToken | Refresh a weboffice token | Menyegarkan token akses Weboffice. Token akses Weboffice berlaku selama 30 menit. Setelah kedaluwarsa, Anda tidak dapat lagi mengakses Weboffice. Untuk terus mengakses Weboffice, panggil operasi ini untuk menyegarkan token akses Weboffice dan mendapatkan token baru yang juga berlaku selama 30 menit. |
| CreateOfficeConversionTask | Membuat tugas konversi dokumen | Membuat tugas konversi dokumen yang mengonversi dokumen (Word, PPT, Excel, PDF) yang disimpan di Object Storage Service (OSS) menjadi gambar, teks, atau PDF. |
| ExtractDocumentText | Ekstrak Teks Isi Dokumen | Mengekstrak teks dari isi file dokumen. |
Pemrosesan file
|
API |
Judul |
Deskripsi |
| Kompresi dan dekompresi | Kompresi dan dekompresi | |
| CreateFileCompressionTask | Membuat Tugas Kompresi File | API Pengunduhan Paket. |
| CreateArchiveFileInspectionTask | Membuat tugas Tampilan dan Penguraian arsip | Membuat tugas Tampilan dan Penguraian arsip yang mengambil daftar file di dalam arsip tanpa mendekompresinya. |
| CreateFileUncompressionTask | Membuat tugas dekompresi | Membuat tugas dekompresi yang mengekstrak file tertentu dari paket terkompresi ke lokasi tertentu atau mengekstrak seluruh paket. Format kompresi yang didukung meliputi ZIP, RAR, dan 7z. |
| Kompresi point cloud | Kompresi point cloud | |
| CreateCompressPointCloudTask | Membuat tugas kompresi point cloud | Mengompresi data point cloud yang disimpan di Object Storage Service (OSS) untuk mengurangi transmisi data jaringan. |
Keamanan konten
|
API |
Judul |
Deskripsi |
| DetectTextAnomaly | Moderasi Konten Teks | Mendeteksi apakah konten teks tertentu mengandung pelanggaran seperti pornografi, iklan, spam, konten sensitif secara politik, atau bahasa kasar. |
| CreateImageModerationTask | Membuat Tugas Moderasi Konten Image | Mendeteksi apakah konten image sesuai ketentuan, mencakup skenario deteksi seperti konten pornografi, terorisme dan sensitivitas politik, adegan tidak pantas, logo, dan pelanggaran image-teks. |
| CreateVideoModerationTask | Membuat tugas deteksi kepatuhan video | Mendeteksi konten berisiko atau tidak patuh dalam video. Skenario yang didukung meliputi deteksi pornografi, deteksi terorisme dan sensitivitas politik, deteksi pelanggaran gambar-teks, deteksi adegan tidak pantas, dan deteksi logo. |
| GetImageModerationResult | Mengambil tugas moderasi konten gambar | Mengambil tugas moderasi konten gambar. |
| GetVideoModerationResult | Mengambil tugas moderasi konten video | Mengambil tugas moderasi konten video. |
Manajemen tugas
|
API |
Judul |
Deskripsi |
| Pemicu | Pemicu | |
| SuspendTrigger | Menjeda pemicu | Menjeda pemicu yang berada dalam status Berjalan. |
| ResumeTrigger | Melanjutkan Pemicu | Melanjutkan pemicu yang berada dalam status Suspended atau Failed. |
| UpdateTrigger | Memperbarui Pemicu | Memperbarui informasi pemicu, seperti konfigurasi sumber data masukan, konfigurasi pemrosesan data, dan tag pemicu. |
| GetTrigger | Mengambil Informasi Pemicu | Mengambil informasi pemicu. |
| ListTriggers | Kueri Daftar Pemicu | Mengkueri daftar node pemicu. Operasi ini mendukung pengurutan dan kueri bersyarat berdasarkan label node, status node, dan kondisi lainnya. |
| Pemrosesan batch | Pemrosesan batch | |
| CreateBatch | Membuat Pekerjaan Batch | Membuat pekerjaan batch. Menentukan file yang ada di penyimpanan dan melakukan operasi batch pada file tersebut, seperti transkoding dan konversi format. |
| SuspendBatch | Menjeda Pekerjaan Batch | Menjeda pekerjaan batch yang berada dalam status Berjalan. |
| ResumeBatch | Melanjutkan Pekerjaan Batch | Melanjutkan pekerjaan batch yang berada dalam status Suspended atau Failed. |
| UpdateBatch | Memperbarui tugas batch | Memperbarui informasi tugas batch, seperti konfigurasi sumber data, konfigurasi pemrosesan data, dan tag tugas batch. |
| ListBatches | Mengkueri tugas batch | Mengkueri daftar tugas batch. Mendukung pengurutan dan kueri bersyarat berdasarkan label node dan status node. |
| GetBatch | Mengambil Informasi Tugas Batch | Mengambil informasi tugas batch. |
| DeleteBatch | Menghapus pekerjaan batch | Menghapus pekerjaan batch yang ditentukan. |
Lainnya
|
API |
Judul |
Deskripsi |
| ContextualAnswer | API Tanya Jawab dalam Asisten AI | Menghasilkan konten tanya jawab dalam percakapan dengan menggunakan API Tanya Jawab Asisten AI, yang memberikan tanggapan berbasis konteks. |
| ContextualRetrieval | API Pengambilan dalam asisten AI | Mengambil dokumen yang secara semantik serupa dalam skenario percakapan multi-putaran. API ini memproses input pesan yang berisi riwayat percakapan dan melakukan analisis konteks mendalam untuk memastikan bahwa hasil pengambilan sangat relevan dengan percakapan saat ini. API ini cocok untuk lingkungan interaktif yang kompleks dan menyediakan pengambilan informasi yang konsisten dan efisien untuk percakapan multi-putaran. |
| ListAttachedOSSBuckets | Daftar Binding Bucket OSS | Mengkueri informasi semua bucket OSS yang terikat pada Proyek. |
Others
|
API |
Judul |
Deskripsi |
| AddStoryFiles | Tambah File Story | Menambahkan file ke story. |
| CreateCustomizedStory | CreateCustomizedStory | Membuat cerita menggunakan gambar dan video yang dipilih. |
| CreateDataset | Membuat set data. | Membuat set data. |
| CreateProject | Membuat proyek. | Membuat proyek. |
| CreateStory | Membuat cerita | Membuat sebuah cerita. |
| CreateTrigger | CreateTrigger | Membuat tugas trigger. Anda dapat menggunakan sumber peristiwa seperti OSS untuk memicu pemrosesan data IMM. Beberapa template pemrosesan data didukung untuk memproses file media seperti gambar, video, dan dokumen. |
| DeleteDataset | DeleteDataset | Menghapus set data. |
| DeleteProject | Menghapus proyek | Menghapus proyek tertentu. |
| DeleteStory | DeleteStory | Menghapus story. |
| DeleteTrigger | Menghapus Pemicu | Menghapus pemicu tertentu. |
| GetDataset | GetDataset | Menanyakan informasi tentang sebuah dataset. |
| GetProject | Kueri informasi proyek. | Mengkueri informasi tentang proyek tertentu, termasuk informasi dasar dan informasi statistik terkait dataset dan file. |
| GetStory | Mengambil Informasi Story | Mengambil informasi tentang sebuah story. |
| GetTask | Mengambil Informasi Tugas | Mengkueri informasi tentang Tugas asinkron tertentu. Intelligent Media Management (IMM) mendukung berbagai kemampuan Pemrosesan data asinkron, masing-masing dengan operasi pembuatan Tugasnya sendiri, seperti CreateFigureClusteringTask untuk membuat Tugas Pengelompokan figur dan CreateFileCompressionTask untuk membuat Tugas kompresi file. Operasi ini merupakan operasi serbaguna yang memungkinkan Anda mengkueri detail Tugas asinkron berdasarkan ID dan tipe Tugas. |
| ListDatasets | Daftar Set Data | Mengambil daftar set data. Anda dapat mengkueri set data berdasarkan awalan nama set data. |
| ListProjects | Mengkueri Semua Informasi Proyek. | Mengkueri informasi tentang semua proyek, termasuk informasi dasar dan informasi statistik terkait dataset dan file. |
| ListRegions | Menanyakan daftar region yang mendukung IMM | Menanyakan daftar region yang mendukung IMM, termasuk region dan informasi deskripsi bahasa yang sesuai. |
| ListTasks | Kueri Daftar Tugas | Menyediakan fitur kueri bersyarat untuk mengkueri daftar node berdasarkan beberapa kondisi. Anda dapat menggunakan operasi ini untuk mengkueri node dalam rentang waktu tertentu atau mencari node berdasarkan tag yang ditentukan saat node dibuat. |
| RemoveStoryFiles | Menghapus file dari story | Menghapus file dari story. |
| UpdateDataset | Memperbarui set data. | Memperbarui informasi set data. |
| UpdateProject | Memperbarui Proyek. | Memperbarui informasi proyek yang telah dibuat. |
| UpdateStory | Memperbarui Cerita | Memperbarui informasi cerita, seperti mengganti nama atau mengubah gambar sampul. |