這一環要分清兩個來源：CapCut的線上素材庫和你的本地檔案。前者有專門的檢索工具，參數是類型、提示詞、返回條數；後者靠代理讀目錄。篩選要靠描述，越具體回得越準；排序要靠清單，想讓代理排時間線，先把時長和內容寫給它。
官方文件裡那個檢索工具叫search_capcut_material，三個參數：type指定素材類型，prompt是描述，top_n是返回條數。文件給的連通用例是type填font、prompt填font、top_n填1，只取一條，因為這一步只是驗證帳號通不通。
這個工具搜的是CapCut自己的線上素材庫，字體、音樂、音效、範本這類東西在裡面。它搜不到你電腦上的檔案，也讀不了你的下載目錄。把這兩個來源混為一談，是這一環最常見的誤解。
它還有一個好處：只讀。文件明確要求不要為了測試連通性去發起付費生成或者改動草稿，所以拿檢索當探針是安全的，不花錢也不動檔案。
你拍的那堆素材怎麼讓代理挑，靠的不是檢索介面，是資料夾和說明。把素材按用途歸到幾個子目錄裡，再用一句話說明每個目錄裝的是什麼，代理掃一遍目錄就能建立索引，比讓它逐個打開檔案快得多。
目錄命名直接決定它能不能挑對。用日期加場景的寫法，比用手機自動生成的IMG加一串數字強太多。檔名裡帶內容關鍵詞，代理在篩選時能直接命中，省掉一輪逐個讀取。
素材量大的時候還要給一份清單檔案。清單裡每行寫檔名、時長、一句話內容、可用片段，代理讀這一份就夠判斷，不用把所有影片都解碼一遍。這一步多做十分鐘，後面省半小時。
代理排時間線，判斷依據只有你給的資訊。它不會自己覺得哪個畫面好看，只能按你寫的時長、順序、情緒、用途去擺。你給的越像分鏡，擺出來的越接近你要的。
最小可用的資訊是三條：每段多長、這段拍的是什麼、這段要放在開頭中間還是結尾。加上景別和機位，排序會明顯更準，因為跳切和軸線這些規則它能用上。
還有一個隱含條件：總時長。你說要做十二秒，它就得在十二秒裡分配這些片段，衝突時必然要砍內容。先把時長定死，再讓它排，比排完再砍要省事。
元資料不是玄學，就是檔案身上那些能讀到的屬性：時長、解析度、幀率、有無音軌。這些代理能自己讀，不需要你手填。
需要你手填的是內容描述。這一段是橫屏還是豎屏、有沒有人說話、說話的人在第幾秒入畫、畫面裡有沒有文字，這幾項決定了它能不能被正確剪輯。尤其是畫面裡有文字的那類，豎屏改橫屏時文字會被裁掉，必須提前標記。
另外一項容易漏的是音軌。素材自帶環境音還是靜音，混音時處理方式完全不同。靜音素材放進片子，剪完發現整段沒聲音，這種返工最冤。
第一看類型參數。type填錯，比如搜音樂卻填了字體，結果一定是空的。這一項是最常見的低級錯誤，檢查成本極低，先看它。
第二看描述。太抽象的提示詞返回空是正常的，把描述換成具體的品類詞，命中率立刻不一樣。
第三看服務狀態。如果返回的是網關錯誤或者服務不可用，那是鏈路問題不是檢索問題。官方文件裡專門寫了這種情況：報服務暫時不可用就停下，不要接著起授權流程，也不要去重裝，等它恢復。想先把本地素材整理成能直接剪的樣子，可以照即夢影片匯入剪映做成片的步驟裡那套命名和歸類的辦法；三個工具一起用的，這套串聯順序裡也有素材歸檔的寫法。
官方文件明確舉例的是字體，說明字體這一類的類型值是font。音樂、音效、範本、貼紙這些是否都能通過同一個類型參數調用，文件沒有逐項列出，需要在實際介面的返回值裡看。保守的用法是先按字體驗證連通，再逐個試你要的那一類，不要一次把類型寫得很寬。
由top_n控制，你要幾條它就返回幾條，文件裡的連通用例是1條。實際篩選素材時可以調大，但別貪多，一次返回幾十條反而不好判斷。分幾輪檢索、每輪換個更具體的描述，比一輪拉一大堆回來再人工挑效率高。先試小數目再放大，條數上限看介面返回，超了會被截斷。
能。排出來的是草稿，時間線可拖，片段可裁，順序可換。改的時候注意一點：手動改過之後，再讓代理接著改，要把它改過的位置告訴它，否則它按舊的假設繼續動，會把你剛調好的部分覆蓋掉。接手動改動之前，先讓它讀一遍當前時間線，別憑記憶。這一步不能省，別跳。
線上庫檢索不受影響，那是按提示詞匹配的。本地素材用中文名也有影響，但影響在傳遞環節：中文名在跨系統、跨壓縮包、跨雲端硬碟時更容易亂碼，一旦亂碼，草稿裡的引用就斷了。穩妥的做法是素材檔名用英文加數字，內容描述單獨寫在清單裡。清單裡寫清楚比檔名更靠得住。
1. CapCut 官方 CapCut×Codex 頁面：https://www.capcut.com/zh-tw/tools/capcut-x-codex
橫屏改豎屏不是把畫面裁窄，是把鏡頭裝進另一個框。橫屏能看到左右，豎屏只能看到中間那一豎條，被裁掉的部分往往是資訊所在...
2026-10-28
十二秒豎屏是官方演示出現過的場景，背後有一套硬約束：總時長固定、畫幅固定、素材數量固定。都限死的時候，剪法就從挑好看...
2026-10-28
代理剪完給的是一份草稿，不是成片，能不能導回剪映國際版精修，取決於這份草稿掛在哪個帳號下。草稿跟帳號走，同帳號兩端能...
2026-10-27
這篇說的是鏈路，不是按鈕。剪映國際版在ChatGPT裡的外掛還沒開放，官方只給了能力清單：搜範本、剪影片、自動字幕、生成圖和...
2026-10-27
外掛測試定在十一月，現在能裝的只有Codex那條路。想在開放前把環境備齊，要準備的項不算多但每項都卡人：終端、Node、帳號地...
2026-10-27