Dokumen ini memperkenalkan parameter sintesis dan contoh pemanggilan SDK untuk produksi video pencocokan cerdas gambar-teks dalam skenario sorotan acara olahraga.
Catatan: Pada antarmuka ini, wilayah dalam semua URL OSS aset media harus konsisten dengan wilayah pada titik akhir layanan OpenAPI.
Wilayah yang didukung: Tiongkok (Shanghai).
Dalam penggunaan aktual, Anda perlu mengganti semua contoh parameter dalam dokumen seperti [your-bucket], [your-region-id], [your-file-name], [your-file-path], dan ID aset media (misalnya, "****9d46c8b4548681030f6e****") dengan nilai aktual Anda.
Untuk pemahaman yang lebih baik mengenai dokumen ini, kami menyarankan Anda terlebih dahulu mempelajari konsep dan alur penggunaan "Produksi Video Pencocokan Gambar-Teks Cerdas Satu Klik – Sorotan Acara Olahraga" melalui Panduan operasi produksi video satu klik cerdas.
Instruksi penggunaan
Untuk deskripsi API pengeditan cerdas dan produksi video batch satu klik dari video lengkap acara olahraga, lihat SubmitSportsHighlightsJob - Kirim tugas sorotan olahraga. Untuk parameter API utama, lihat parameter InputConfig dan OutputConfig di bawah ini.
Untuk informasi detail mengenai pekerjaan produksi video batch cerdas satu klik, lihat GetBatchMediaProducingJob - Dapatkan informasi tugas produksi video batch cerdas satu klik.
Parameter InputConfig
Anda dapat mengonfigurasi InputConfig untuk menentukan parameter material dasar, seperti material video, narasi suara, musik latar, dan stiker.
Parameter | Tipe | Deskripsi | Nilai contoh | Wajib |
SportsCategory | String | Jenis acara olahraga Bola Basket: bola basket Tenis meja: pingpong | basketball | Ya |
InputMedia | String | Material acara olahraga input. Mendukung MediaId atau MediaURL
| ****9d46c8b4548681030f6e**** | Ya |
FaceRegister | List<FaceInfo> | Identitas orang, panjang array kurang dari atau sama dengan 5. | Lihat Contoh parameter | Tidak |
SlowMotionLogoRegister | Identifikasi gerakan lambat. Jika gerakan lambat diperlukan dalam video akhir, Anda perlu memberikan informasi identifikasi logo yang muncul sebelum gerakan lambat dalam video sumber. Panjang array kurang dari atau sama dengan 5. | Lihat Contoh parameter | Tidak | |
TransferNameRegister | List<TransferNameInfo> | Identifikasi transkripsi nama, yang mengonversi singkatan nama tim pada papan skor menjadi nama tim lengkap. Panjang array kurang dari atau sama dengan 10. | Lihat Contoh parameter | Ya |
Parameter FaceInfo
Field | Tipe | Deskripsi | Nilai contoh | Wajib |
FaceUrls | List<String> |
| ["http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png","http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png""] | Ya |
Name | String | Nama orang, harus sesuai dengan nama yang ditampilkan pada papan skor dalam video input | James | Ya |
Parameter SlowMotionLogoRegister
Field | Tipe | Deskripsi | Nilai contoh | Wajib |
SlowMotionLogoUrls | List<String> |
| ["http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png","http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png""] | Ya |
Parameter TransferNameInfo
Field | Tipe | Deskripsi | Nilai contoh | Wajib |
OriginalName | String | Singkatan nama tim pada papan skor acara | Rockets | Ya |
TransferName | String | Nama tim lengkap | Houston Rockets | Ya |
Contoh parameter
{
"SportsCategory": "Basketball",
"InputMedia": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4",
"FaceRegister": [
{
"FaceUrls": ["http://testcdn.com/front.jpg", "http://testcdn.com/side.jpg"],
"Name": "James"
}
],
"SlowMotionLogoRegister": {
"SlowMotionLogoUrls": ["http://testcdn.com/logo1.jpg", "http://testcdn.com/logo2.jpg"]
},
"TransferNameRegister": [
{
"OriginalName": "IND",
"TransferName": "Indiana Pacers"
}
]
}Parameter EditingConfig
Konfigurasi parameter EditingConfig saat ini tidak didukung.
Parameter OutputConfig
Anda dapat mengonfigurasi OutputConfig untuk menentukan parameter sintesis, seperti alamat output, aturan penamaan, resolusi video akhir (lebar dan tinggi), serta jumlah video output.
Parameter | Tipe | Deskripsi | Nilai contoh | Wajib |
MediaURL | String | Alamat video output, harus menyertakan placeholder {index}. | Aturan: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4 Contoh: http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4 | Wajib jika GeneratePreviewOnly=false dan output ke OSS |
StorageLocation | String | Menentukan alamat penyimpanan untuk file media yang dioutput ke VOD. | Aturan: [your-vod-bucket].oss-[your-region-id].aliyuncs.com Contoh: outin-****6c886b4549d481030f6e****.oss-cn-shanghai.aliyuncs.com | Wajib jika GeneratePreviewOnly=false dan output ke VOD |
FileName | String | Nama file output, harus menyertakan placeholder {index}. | Aturan: [your-file-name]__{index}.mp4 Contoh: example_{index}.mp4 | Wajib jika GeneratePreviewOnly=false dan output ke VOD |
GeneratePreviewOnly | Boolean |
| false | Tidak, default adalah false |
Count | Integer | Jumlah video output. Saat ini hanya mendukung Count=1. Dukungan untuk beberapa video output mungkin akan ditambahkan di masa mendatang. | 1 | Tidak, default adalah 1 |
Width | Integer | Lebar video dalam px | 1080 | Ya |
Height | Integer | Tinggi video dalam px | 1920 | Ya |
JSONObject | Konfigurasi terkait aliran video output, seperti Crf, Codec, dll. | {"Crf": 27} | Tidak |
Contoh parameter
{
"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/xxx_{index}.mp4",
"Count": 1,
"Width": 1080,
"Height": 1920,
"Video": {"Crf": 27},
"GeneratePreviewOnly":false
}Contoh pemanggilan SDK
Prasyarat
Anda telah menginstal SDK server IMS. Untuk informasi selengkapnya, lihat Persiapan.
Contoh kode
Detail parameter pemanggilan API
Logika pemrosesan
Menentukan jenis acara olahraga berdasarkan SportsCategory: basket-basketball, tenis meja-pingpong.
Menggunakan parameter identitas orang FaceRegister untuk menentukan bidikan atlet mana yang harus muncul dalam video akhir.
Menggunakan parameter identifier gerakan lambat SlowMotionLogoRegister untuk menentukan ulangan gerakan lambat mana yang harus disertakan dalam video akhir.
Menggunakan parameter transkripsi nama TransferNameRegister untuk mengonversi singkatan nama tim pada papan skor menjadi nama tim lengkap.