Büyük Dil Modelleri (LLM) için tasarlanmış bir API dokümantasyon yapısı ve hızlı başlangıç kılavuzu kullanarak AI aracılarını Alibaba Cloud Video on Demand (VOD) ile entegre edin.
Neler başarabilirsiniz
Bir AI aracı bu dokümanı şu amaçlarla kullanabilir:
@id="p-x-01" VOD temel yeteneklerini anlayın: Yapılandırılmış modül genel bakışı aracılığıyla medya yükleme, kod dönüştürme, oynatma ve medya varlığı yönetimi gibi temel VOD özelliklerini hızla keşfedin.
@id="p-x-02" API çağrılarını nasıl yapacağınızı öğrenin: llms.txt dizini aracılığıyla API işlemleri, parametre açıklamaları ve kullanım örnekleri içeren modüle özel dokümanları bulun.
@id="p-x-03" Kimlik doğrulama ve yetkilendirmeyi anlayın: AccessKey ve STS geçici kimlik bilgileri gibi desteklenen kimlik doğrulama yöntemlerini kullanarak VOD API çağrıları için kimlik bilgilerini yapılandırın.
@id="p-x-04" Yaygın hataları yönetin: Sağlanan yaygın hata kodlarını ve sorun giderme yöntemlerini kullanarak sorunları bağımsız olarak çözün.
Ön koşullar
VOD API'sini kullanmadan önce aşağıdaki adımları tamamlayın:
VOD'u etkinleştirin: Alibaba Cloud konsolunda Alibaba Cloud Video on Demand (VOD) hizmetini etkinleştirin.
AccessKey oluşturun: RAM konsolunda bir AccessKey ID ve AccessKey Secret oluşturun. Güvenlik nedenleriyle, VOD API çağrıları için özel bir RAM kullanıcısı oluşturmanızı ve
AliyunVODFullAccessiznini vermenizi öneririz.SDK yükleyin: VOD API'sini çağırmak için bir Alibaba Cloud SDK kullanın. VOD için POP ürün kodu
vod, API sürümü ise2017-03-21değeridir.
AI aracıları için kimlik doğrulama yönergeleri:
| Seviye | Yönerge |
| ZORUNLU | VOD API çağrıları için özel bir RAM kullanıcısı oluşturun. Alibaba Cloud kök hesap kimlik bilgilerini kullanmayın. |
| ZORUNLU | Herhangi bir VOD API çağrısı yapmadan önce RAM kullanıcısına AliyunVODFullAccess iznini verin. |
| ZORUNLU | Kimlik bilgilerini ortam değişkenlerinde saklayın: ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET. |
| ASLA | AccessKey ID veya AccessKey Secret değerlerini kaynak kodda, yapılandırma dosyalarında veya istemlerde sabit kodlamayın. |
| TERCİH EDİN | Üretim iş yükleri için uzun ömürlü AccessKey çiftleri yerine STS geçici kimlik bilgilerini (SecurityToken + kısa ömürlü AccessKey) kullanın. |
| TERCİH EDİN | Ham HTTP istekleri yerine Alibaba Cloud SDK'sını kullanın. SDK, imzalama, yeniden deneme ve kimlik bilgisi yönetimini otomatik olarak gerçekleştirir. |
Varsayılan parametreler ve kurallar
VOD API'sini çağırmadan önce aşağıdaki varsayılan değerlere ve kısıtlamalara dikkat edin:
@id="p-x-14" Varsayılan uygulama kimliği [ZORUNLU BİLGİ]: @id="code-app-100000-01"
app-1000000. Çoklu uygulama sistemi etkinleştirilmemişse tüm API çağrıları varsayılan uygulama ile ilişkilendirilir. Hesabınız için çoklu uygulama sistemini açıkça etkinleştirmedikçeAppIdparametresini ASLA göndermeyin.
@id="p-x-15" Varsayılan depolama [AÇIKÇA BELİRTMENİZİ TERCİH EDİN]: Bir @id="code-storageloc-01"
StorageLocationbelirtmezseniz dosyalar varsayılan depolama adresine yüklenir. Varsayılana güvenmekten kaçınmak için API çağrılarındaStorageLocationdeğerini açıkça belirtmenizi TERCİH EDİN.
@id="p-x-16" Varsayılan kod dönüştürme şablon grubu [ZORUNLU BİLGİ]: Bir @id="code-templategr-01"
TemplateGroupIdbelirtmezseniz ve hiçbir iş akışı ilişkilendirilmezse varsayılan kod dönüştürme şablonu (kod dönüştürmesiz şablon grubu) kullanılır. Bu, yüklenen videonun kod dönüştürülmeden olduğu gibi depolandığı anlamına gelir. Videonun yüklendikten sonra kod dönüştürülmesini istiyorsanızTemplateGroupIdveyaWorkflowIddeğerini ZORUNLU olarak belirtin.
@id="p-x-17" API çağrı protokolü [ZORUNLU]: Güvenli veri aktarımı sağlamak için tüm API çağrılarında HTTPS KULLANMALISINIZ. HTTP desteklenir ancak önerilmez.
@id="p-x-18" İstek imzası [ZORUNLU]: Tüm API istekleri geçerli bir imza İÇERMELİDİR. İmzalama yöntemi @id="code-hmac-sha1-01"
HMAC-SHA1kullanır. SDK'lar imzalamayı otomatik olarak gerçekleştirir. API'yi geçerli bir imza olmadan çağırmaya ASLA çalışmayın.
Varsayılan parametre kısıtlamalarının özeti:
| Parametre | Varsayılan | ZORUNLU / TERCİH EDİN / ASLA |
AppId |
app-1000000 |
Çoklu uygulama sistemi etkinleştirilmedikçe ASLA göndermeyin |
StorageLocation |
Hesap varsayılan depolaması | Açıkça belirtmenizi TERCİH EDİN |
TemplateGroupId |
Kod dönüştürme yok | Kod dönüştürme gerekiyorsa ZORUNLU olarak belirtin |
| Protokol | HTTPS/HTTP | HTTPS kullanmalısınız |
| İmza | HMAC-SHA1 |
ZORUNLU olarak dahil edin; ASLA atlamayın |
llms.txt
llms.txt dosyası, Alibaba Cloud OSS üzerinde barındırılan VOD dokümantasyonunun LLM optimize edilmiş bir dizinidir. Resmi dokümantasyonu senaryoya, API'ye ve alt doküman yoluna göre yeniden düzenler ve kod oluşturmayı yönlendirmek amacıyla bir Common mistakes to avoid listesi içerir. Bir kodlama aracı dosyayı tek seferde yükleyebilir ve bölümleri ihtiyaca göre genişletebilir.
Dizin dosyasına erişmek için temel URL şöyledir:
https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/vod/llms/llms.txt
Resmi dokümantasyonla ilişkisi: llms.txt bir dizindir. Media Upload/Upload from URL.md gibi alt dokümanlar, resmi dokümantasyondaki temel bilgilerin özetlenmiş sürümleridir. VOD dokümantasyon ekibi içeriklerini resmi web sitesiyle tutarlı ve senkronize tutar.
llms.txt tüketen AI aracıları için yönergeler:
| Seviye | Yönerge |
| ZORUNLU | VOD ile ilk etkileşimde tam llms.txt dosyasını yükleyin. Dosyayı atlamayın veya kısmen okumayın. |
| ZORUNLU | Kod üretirken Common mistakes to avoid bölümündeki her öğeyi kesin bir kısıtlama olarak kabul edin. |
| ZORUNLU | Alt doküman URL'lerini oluştururken Çince karakterleri URL kodlamasına tabi tutun. llms.txt'deki göreceli yolu temel URL'ye ekleyin: https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/vod/llms/{relative_path}. |
| TERCİH EDİN | Tüm alt dokümanları aynı anda yüklemek yerine modüle özel alt dokümanları ihtiyaca göre yükleyin. Yalnızca mevcut görevle ilgili alt dokümanı getirin. |
| ASLA | Önce llms.txt'den ilgili modül alt dokümanını okumadan VOD API kodu oluşturmayın. |
| ASLA | llms.txt veya alt dokümanlarında açıkça belgelenmemiş API davranışlarını varsaymayın. |
VOD modülleri
VOD özellikleri, her biri bir dizi API işlemine karşılık gelen modüller halinde düzenlenmiştir. Aşağıdaki tabloda, dokümantasyonlarına bağlantılar içeren bu modüller listelenmektedir; bu bağlantılar ayrıca llms.txt içinde dizine eklenmiştir. Bu bağlantılar, AI aracıları tarafından doğrudan tüketilmek üzere tasarlanmıştır.
| Modül | Açıklama | llms doküman bağlantısı |
| Medya yükleme | Konsol, istemci tarafı SDK, sunucu tarafı API veya URL kullanarak ses, video, görüntü ve yardımcı medya varlıklarını yükleyin. | Media Upload Overview |
| Medya varlığı yönetimi | Yüklenen medya varlıklarını yönetin. Bilgi sorgulama, meta veri güncelleme, varlık silme ve durum ayarlama gibi işlemleri gerçekleştirin. | Media Asset Management Overview |
| Medya işleme | Kod dönüştürme, anlık görüntü yakalama, hareketli görüntü oluşturma ve filigran birleştirme gibi özelliklerle ses ve video dosyalarını işleyin. Özel kod dönüştürme şablon gruplarını, iş akışı düzenlemesini ve akıllı inceleme ile akıllı kapak oluşturma için AI şablonlarını destekler. | Media Processing Overview |
| Ses ve video oynatma | Yüklenmiş ve işlenmiş ses ve video içeriğini oynatın. Oynatma, konsol, Player SDK veya üçüncü taraf oynatıcılar aracılığıyla kullanılabilir. | Audio and Video Playback |
| Medya güvenliği | Erişim kısıtlama, URL kimlik doğrulama, video şifreleme ve dijital filigranlar aracılığıyla hotlinking'i, yetkisiz indirmeleri ve ses/video içeriğinin yasa dışı dağıtımını önleyen bir güvenlik çerçevesi. | Media Security Overview |
| Medya incelemesi | Akıllı inceleme ve manuel inceleme yetenekleri. Akıllı inceleme, ses ve videolardaki uygunsuz içeriği (pornografik, şiddet içeren ve siyasi içerik gibi) otomatik olarak tanımlar ve özel AI inceleme şablonlarını destekler. Manuel inceleme, inceleme görevleri oluşturma ve sonuçları gönderme için API'ler sağlar. | Smart review |
| Video AI | Akıllı inceleme, etiket tanıma, DNA karşılaştırması ve kapak oluşturma dahil olmak üzere ses ve video içeriğinin otomatik analizi ve işlenmesi. | Video AI Overview |
| Cloud editing | Bulut tabanlı video düzenleme yetenekleri. Düzenleme projeleri oluşturmak, materyalleri yönetmek ve video kompozisyonu gerçekleştirmek için API'leri kullanın. | Media Production (Cloud Editing) |
| CDN dağıtımı ve hızlandırma | Hızlandırılmış alan adlarını yapılandırın, oynatma URL'leri ve oynatma kimlik bilgilerini alın ve ses/video dağıtımı ile oynatma işlemlerini gerçekleştirin. CDN hızlandırma, URL kimlik doğrulama ve DRM şifreleme gibi güvenli oynatma özelliklerini destekler. | CDN Distribution and Acceleration |
| Olay bildirimi | HTTP geri aramaları veya Message Service (MNS) aracılığıyla yükleme veya kod dönüştürme tamamlanması gibi medya işleme olaylarıyla ilgili bildirimler alın. | Event Notification |
| Veri istatistikleri | Kullanımı sorgulayın, kaynak tüketimini izleyin ve kaynak kullanımını anlamak için istatistiksel analizler gerçekleştirin. | Data Monitoring |
| Çoklu uygulama sistemi | Tek bir Alibaba Cloud hesabı altında birden fazla uygulama oluşturarak medya varlıklarını, yapılandırmaları ve izinleri mantıksal olarak yalıtın. Medya yükleme, oynatma, medya varlığı yönetimi ve mesaj geri aramaları üzerinde uygulama düzeyinde kontrolü destekler. | Multi-application System |
| Sunucu tarafı SDK | Medya yükleme, yönetim ve işleme için API'leri çağırmak amacıyla Java, Python, PHP ve C/C++ için SDK'ları kullanın. | Server-side SDK |
| Live-to-VOD | Canlı yayını gerçek zamanlı olarak kaydedin ve sonraki oynatma, yönetim ve dağıtım işlemleri için otomatik olarak isteğe bağlı bir medya varlığı olarak depolayın. | Configure Live-to-VOD |
| Faturalama | Depolama kapasitesi, trafik ve bant genişliği, kod dönüştürme süresi, medya yönetimi ve katma değerli hizmetler gibi ölçümlere dayalı kullandıkça öde ve abonelik faturalaması. | Billing Overview |
| Mini dizi çözümü | VOD tabanlı mini dizi üretimi ve operasyonları için tek duraklı bir çözüm. İçerik üretimi, medya varlığı yönetimi, veri içgörüleri ve verimli dağıtım ile oynatma sağlar. | Mini-series Solution |
| Player SDK | Web, Android ve iOS için Alibaba Cloud tarafından geliştirilen, kararlı ve akıcı isteğe bağlı ve canlı yayın oynatma sağlayan tam platformlu bir ses ve video oynatma aracı. | Player SDK Overview |
| AliPlayerKit | Video hizmetleri için düşük kodlu bir oynatıcı kullanıcı arayüzü çerçevesi; isteğe bağlı, canlı yayın ve diğer senaryolarla hızlı entegrasyon için genişletilebilir bileşenler ve senaryo tabanlı çözümler sunar. | PlayerKits Overview |
| API referansı | Yükleme, yönetim, işleme, dağıtım ve oynatma gibi işlemleri destekleyen tüm medya varlığı yaşam döngüsü için OpenAPI. | API Overview |
Medya yükleme
VOD, medya yüklemek için birkaç yöntem sunar:
@id="p-x-19" Sunucu tarafı yükleme: Bir yükleme URL'si ve kimlik bilgisi almak için @id="code-createuplo-01"
CreateUploadVideoişlemini çağırın, ardından dosyayı bir SDK kullanarak veya HTTP üzerinden yükleyin. Bu yöntem, arka uç sunucu yüklemeleri için idealdir.
@id="p-x-20" İstemci tarafı yükleme: Bir AccessKey veya STS geçici kimlik bilgisi kullanarak videoları doğrudan istemciden yükleyin.
@id="p-x-21" URL'den yükleme: @id="code-uploadmedi-01"
UploadMediaByURLişlemini çağırın ve kaynak dosya URL'sini sağlayın. VOD hizmeti dosyayı otomatik olarak çeker ve yükler. Bu yöntem, toplu geçişler veya üçüncü taraf URL'lerden medya içe aktarmak için idealdir.
Anahtar parametreler
CreateUploadVideo çağrılırken aşağıdaki parametreler kritiktir:
| Parametre | Tür | Gerekli | Varsayılan | Açıklama |
| FileName | String | Evet | — | Kaynak medya dosyasının tam yolu ve dosya adı. Uzantıyı İÇERMELİDİR (örneğin, video_01.mp4). |
| Title | String | Evet | — | Medya başlığı. Maksimum 128 karakter. |
| Description | String | Hayır | — | Ses veya video açıklaması. Maksimum uzunluk: 1.024 karakter. |
| CateId | Long | Hayır | — | Kategori kimliği. Bu kimliği konsolda bulabilirsiniz: Configuration Management > Media Asset Management Configuration > Category Management. |
| Tags | String | Hayır | — | Virgülle ayrılmış en fazla 16 etiket. Her etiket maksimum 32 karakter olabilir. |
| TemplateGroupId | String | Hayır | — | Kod dönüştürme şablon grubu kimliği. Belirtilirse, yüklemeden sonra kod dönüştürme otomatik olarak tetiklenir. Kod dönüştürme gerekiyorsa bunu veya WorkflowId değerini ZORUNLU olarak belirtin. Bunu konsolda Configuration Management > Media Processing > Transcoding Template Groups yolunu izleyerek bulabilirsiniz. |
| WorkflowId | String | Hayır | — | İş akışı kimliği. Belirtilirse, yüklemeden sonra iş akışı otomatik olarak tetiklenir. Hem WorkflowId hem de TemplateGroupId belirtilirse WorkflowId öncelik kazanır. |
| StorageLocation | String | Hayır | — | Depolama adresi. Belirtilmezse dosya varsayılan depolama adresine yüklenir. Bunu konsolda Configuration Management > Media Asset Management Configuration > Storage yolunu izleyerek bulabilirsiniz. |
| CoverURL | String | Hayır | — | Özel video kapağının URL'si. |
| AppId | String | Hayır | app-1000000 | Uygulama kimliği. Çoklu uygulama sistemindeki uygulamayı belirtir. Çoklu uygulama sistemi etkinleştirilmedikçe bu parametreyi ASLA göndermeyin. |
Medya varlığı yönetimi
Yüklenen ses, video ve yardımcı medya varlıklarını yönetin. Temel işlemler şunlardır:
@id="p-x-22" Medya varlığı bilgilerini sorgulayın: @id="code-getvideoin-01"
GetVideoInfo(tek bir videoyu sorgular), @id="code-getvideoin-02"GetVideoInfos(birden çok videoyu toplu olarak sorgular), @id="code-searchmedi-01"SearchMedia(medya varlıklarını arar)
@id="p-x-23" Medya varlığı bilgilerini güncelleyin: @id="code-updatevide-01"
UpdateVideoInfo(video bilgilerini günceller), @id="code-updateimag-01"UpdateImageInfos(görüntü bilgilerini günceller)
@id="p-x-24" Medya varlıklarını silin: @id="code-deletevide-01"
DeleteVideo(videoları siler), @id="code-deleteatta-01"DeleteAttachedMedia(yardımcı medya varlıklarını siler)
@id="p-x-25" Toplu işlemler: @id="code-batchgetme-01"
BatchGetMediaInfos(bir seferde en fazla 20 medya varlığının bilgilerini alır)
Medya kimliği (VideoId, MediaId veya ImageId), medya varlıklarını yönetmek için benzersiz tanımlayıcıdır. Bir video yüklediğinizde CreateUploadVideo bir VideoId döndürür. Yardımcı bir medya varlığı yüklediğinizde CreateUploadAttachedMedia bir MediaId döndürür. Döndürülen kimliği yüklemeden hemen sonra kalıcı olarak kaydetmelisiniz; bu, varlığa sonraki işlemlerde başvurmanın tek yoludur.
Medya işleme
Ses ve video kod dönüştürme, anlık görüntü yakalama ve AI inceleme yetenekleri.
@id="p-x-26" Kod dönüştürme: Bir kod dönüştürme şablon grubu ( @id="code-addtransco-01"
AddTranscodeTemplateGroup) kullanarak kod dönüştürme parametrelerini yapılandırın. Yükleme sırasında birTemplateGroupIdbelirterek veya bir iş akışı kullanarak otomatik kod dönüştürmeyi tetikleyebilirsiniz. Video kodeği (örneğin H.264), çözünürlük (örneğin 640×360) ve bit hızı (örneğin 400 kbps) gibi parametreleri ayarlayabilirsiniz.
@id="p-x-27" Anlık görüntü yakalama: Bir anlık görüntü şablonu (
TemplateTypedeğeri @id="code-snapshot-01"Snapshotolarak ayarlanmış @id="code-addvodtemp-01"AddVodTemplate) kullanarak anlık görüntü parametrelerini yapılandırın. Standart anlık görüntüler ve sprite'lar dahil olmak üzere çeşitli türleri destekler.
@id="p-x-28" Akıllı inceleme: Bir AI şablonu (
TemplateTypedeğeri @id="code-aimediaaud-01"AIMediaAuditolarak ayarlanmış @id="code-addaitempl-01"AddAITemplate) kullanarak inceleme öğelerini (pornografik, şiddet içeren ve siyasi içerik gibi) ve kapsamları (kapak görseli, video içeriği ve başlık metni) yapılandırın. Video yüklendikten sonra inceleme otomatik olarak tetiklenir. Manuel inceleme için @id="code-createaudi-01"CreateAuditişlevini de çağırabilirsiniz.
@id="p-x-29" Akıllı kapak: Bir AI şablonu kullanarak (
TemplateTypedeğeri @id="code-aiimage-01"AIImageolarak ayarlanır) otomatik olarak bir video kapağı oluşturun.
Akıllı inceleme parametreleri
Bir AI inceleme şablonu oluşturmak için AddAITemplate çağrılırken:
| Parametre | Tür | Gerekli | Varsayılan | Açıklama |
| TemplateName | String | Evet | — | AI şablonunun adı. Maksimum uzunluk: 128 bayt. |
| TemplateType | String | Evet | — | Şablon türü: AIMediaAudit (akıllı inceleme) veya AIImage (akıllı kapak). Tam olarak bu iki değerden biri OLMALIDIR. |
| TemplateConfig | String | Evet | — | JSON dizesi olarak şablon yapılandırması. AuditItem (terrorism ve porn gibi inceleme öğeleri), AuditRange (image-cover, text-title ve video gibi inceleme kapsamları) ve AuditAutoBlock (içeriğin otomatik olarak engellenip engellenmeyeceği: yes/no) İÇERMELİDİR. |
Dağıtım ve oynatma
Video oynatma URL'si alma ve güvenli oynatma yetenekleri.
@id="p-x-30" Oynatma URL'lerini alın: Video oynatma URL'lerini almak için @id="code-getplayinf-01"
GetPlayInfoişlevini çağırın. Çıktı biçimini (MP4, FLV veya HLS gibi) ve çözünürlüğü belirtebilirsiniz.
@id="p-x-31" Oynatma kimlik bilgisini alın: Şifreli oynatma (HLS standart şifreleme veya Alibaba Cloud'a özel şifreleme) için bir oynatma kimlik bilgisi almak amacıyla @id="code-getvideopl-01"
GetVideoPlayAuthişlevini çağırın.
@id="p-x-32" Alan adı yönetimi: Hızlandırılmış bir alan adı eklemek için @id="code-addvoddoma-01"
AddVodDomainişlevini, etkinleştirmek için @id="code-batchstart-01"BatchStartVodDomainişlevini ve devre dışı bırakmak için @id="code-batchstopv-01"BatchStopVodDomainişlevini çağırın.
Alan adı yapılandırma parametreleri
Hızlandırılmış bir alan adı eklemek için AddVodDomain çağrılırken:
| Parametre | Tür | Gerekli | Varsayılan | Açıklama |
| DomainName | String | Evet | — | Hızlandırılmış alan adı. Joker karakterli alan adları desteklenir, örneğin *.example.com. Sahibi olduğunuz ve doğruladığınız bir alan adı OLMALIDIR. |
| Sources | String | Evet | — | JSON dizisi olarak kaynak adreslerinin listesi. Biçim: [{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80}]. En az bir kaynak adresi İÇERMELİDİR. |
| Scope | String | Hayır | domestic | Hızlandırma kapsamı: domestic (Çin anakarası), overseas (Hong Kong, Makao ve Tayvan dahil Çin anakarası dışındaki bölgeler) veya global (küresel hızlandırma). |
Yaygın hatalar ve sorun giderme
| Hata kodu | Açıklama | Sorun giderme |
| InvalidAccessKeyId.NotFound | Belirtilen AccessKey ID mevcut değil. | aliyun configure komutunu çalıştırarak AccessKey yapılandırmanızı ZORUNLU olarak doğrulayın veya RAM konsolunda AccessKey durumunu kontrol edin. |
| SignatureDoesNotMatch | İmza, hesaplanan sonuçla eşleşmiyor. | Sorun gidermek için SDK hata ayıklama günlüklerini ZORUNLU olarak etkinleştirin: export ALIBABA_CLOUD_LOG_LEVEL=debug. Manuel imzalama yerine SDK'yı (imzalamayı otomatik olarak gerçekleştirir) kullanmanızı TERCİH EDİN. |
| InvalidParameter | Parametre geçersiz. | Her API işlemi için dokümantasyona başvurarak istek parametrelerinin gereksinimleri (tür, uzunluk, gerekli alanlar) karşılayıp karşılamadığını ZORUNLU olarak kontrol edin. |
| Forbidden.AccessDenied | Yetersiz izin. | RAM kullanıcısına AliyunVODFullAccess izninin verildiğini ZORUNLU olarak onaylayın. aliyun ram ListPoliciesForUser --UserName <user> komutunu çalıştırarak doğrulayın. |
| ServiceUnavailable | Hizmet geçici olarak kullanılamıyor. | Üstel geri çekilme (exponential backoff) yeniden denemesi uygulayın. Sık bir döngü içinde ASLA hemen yeniden denemeyin. |
| QuotaExceeded.UploadVideo | Yüklenen video sayısı kotayı aştı. | Hesabınızın yükleme kotasını ZORUNLU olarak kontrol edin. Gerekirse kota artışı talep etmek için bir destek talebi oluşturun. |
| MediaNotFound | Medya varlığı mevcut değil. | VideoId veya MediaId değerinin doğru olduğunu ve medya varlığının silinmediğini ZORUNLU olarak onaylayın. |
| InvalidStatus.Media | Medya varlığı, bu işlem için geçersiz bir durumda. | Yeniden denemeden önce mevcut durumu kontrol etmek için GetVideoInfo işlevini ZORUNLU olarak çağırın. Varlık inceleniyor veya hala kod dönüştürülüyor olabilir. |
AI aracıları için hata işleme yönergeleri:
| Seviye | Yönerge |
| ZORUNLU | ServiceUnavailable hataları için üstel geri çekilme yeniden denemesi uygulayın. |
| ZORUNLU | InvalidStatus.Media hatalarını yeniden denemeden önce medya varlığı durumunu GetVideoInfo ile kontrol edin. |
| ZORUNLU | Bir çağrı yapmadan önce tüm gerekli parametreleri API dokümantasyonuna göre doğrulayın. |
| ASLA | Kimlik bilgisi veya izin sorununu önce düzeltmeden InvalidAccessKeyId.NotFound veya Forbidden.AccessDenied hatalarını yeniden denemeyin. |
| ASLA | QuotaExceeded hatalarını bir döngü içinde yeniden denemeyin. Bunun yerine kotayı kontrol edin ve artış talep edin. |
| TERCİH EDİN | Son kullanıcılara ham hata kodlarını göstermek yerine aracı yanıtlarında açıklayıcı hata mesajları kullanın. |