首页 AI 用 Codex 批次上傳 Facebook 廣告素材(2026):/adimages 取得 hash、跨帳戶複製、批次建立創意與素材疲勞監控

用 Codex 批次上傳 Facebook 廣告素材(2026):/adimages 取得 hash、跨帳戶複製、批次建立創意與素材疲勞監控

用 OpenAI Codex 寫 Facebook 廣告素材批次上傳工具:/adimages 上傳取得 hash、copy_from 跨帳戶複製、冪等鍵建立創意、creative_fatigue Webhook 監控,附 Python 範例與人工審核流程。

最後更新:2026-11-16(Meta、Anthropic、OpenAI 官方文件皆於當天查閱)

Facebook 投放裡最機械化的工作,大概就是「把幾十張圖傳上去、記下每張的 hash、再一張張組成創意」。這正好適合交給 OpenAI Codex:讓它寫一套可測試的批次上傳工具,你只負責素材審核和最後的啟用。Claude 版本(簡體中文)請看 用 Claude 生成並批次上傳素材。

工具組成

工具/檔案用途Codex 產出人工檢查
approved/只放審核通過的圖片—品牌、版權、政策
upload_images.py上傳並記錄 檔名→hash程式與測試抽查上傳結果
copy_images.py用 copy_from 複製到其他帳戶程式確認目標帳戶有授權
make_creatives.py文案 × 圖片 組合建立創意程式(含冪等鍵)預覽
fatigue_webhook.py接收素材疲勞通知程式決定換素材
Codex 產出的 Facebook 廣告素材批次上傳工具與人工檢查點

第 1 步:先寫 AGENTS.md

Codex 每次工作前會讀 AGENTS.md(AGENTS.md)。素材相關的規則要特別寫清楚:只處理 approved/ 資料夾、不修改原圖、不把權杖寫進程式碼。

# AGENTS.md  (repo root) - rules Codex reads before every task
## Meta ads automation rules
- Only touch ad accounts listed in accounts.allowlist (our own / client-authorised).
- Read tokens from env vars (META_SYSTEM_USER_TOKEN, META_ADS_MCP_TOKEN). Never print,
  log or commit them. Never put them in prompts.
- Create every campaign, ad set and ad with status=PAUSED. Never activate anything.
- Never raise a daily budget by more than 20% in one change; budgets are in cents.
- Always send X-Client-Idempotent-Key on create calls; reuse it on retries.
- Respect rate limits: back off on error codes 4, 17, 613, 80000-80014.
- Run `pytest -q` and `python -m scripts.dry_run` before proposing changes.
- Ad copy must follow Meta Advertising Standards; flag health, finance,
  employment, housing, politics and gambling for human review.

第 2 步:上傳圖片取得 hash

/adimages 重點說明
檔名必須含副檔名,例如 sample.jpg
回傳images 物件,內含每張圖的 hash
跨帳戶複製copy_from:source_account_id + hash
複製權限應用使用者需能讀取來源帳戶的創意
刪除限制已被廣告創意使用的圖片無法刪除
Facebook Marketing API adimages 端點重點整理

來源:Ad Image 參考。請 Codex 依此寫上傳腳本,並以模擬回應寫單元測試:

# .env  (add .env to .gitignore; never commit or paste tokens into a prompt)
META_API_VERSION=v27.0
META_AD_ACCOUNT_ID=act_<AD_ACCOUNT_ID>
META_PAGE_ID=<PAGE_ID>
META_SYSTEM_USER_TOKEN=<SYSTEM_USER_ACCESS_TOKEN>
# meta_api.py - minimal Marketing API client (Python 3.10+, pip install requests)
import os, time, json, uuid, requests

API = "https://graph.facebook.com/" + os.environ.get("META_API_VERSION", "v27.0")
TOKEN = os.environ["META_SYSTEM_USER_TOKEN"]          # from env / secret manager only
ACT = os.environ["META_AD_ACCOUNT_ID"]                # e.g. act_1234567890
THROTTLE = {4, 17, 613, 80000, 80003, 80004, 80014}   # rate-limit codes in Meta's docs

def call(method, path, params=None, data=None, idem_key=None, tries=5):
    headers = {"X-Client-Idempotent-Key": idem_key} if idem_key else {}
    for attempt in range(tries):
        r = requests.request(method, f"{API}/{path}", headers=headers, timeout=60,
                             params={**(params or {}), "access_token": TOKEN} if method == "GET" else None,
                             data={**(data or {}), "access_token": TOKEN} if method != "GET" else None)
        for h in ("X-Business-Use-Case-Usage", "X-Ad-Account-Usage", "X-FB-Ads-Insights-Throttle"):
            if h in r.headers:
                print(h, r.headers[h])                    # log usage, back off early
        body = r.json()
        err = body.get("error")
        if not err:
            return body
        if err.get("code") in THROTTLE or r.status_code >= 500:
            time.sleep(min(60 * 2 ** attempt, 900))      # exponential backoff
            continue                                     # same idem_key -> no duplicates
        raise RuntimeError(json.dumps(err))
    raise RuntimeError("rate limited: giving up, try later")

def key(run_id, name):
    """Stable idempotency key per object, so a retry never creates a duplicate."""
    return str(uuid.uuid5(uuid.NAMESPACE_URL, f"{ACT}/{run_id}/{name}"))
# upload_images.py - upload approved images, keep name -> hash mapping
import os, glob, json, requests
from meta_api import API, TOKEN, ACT

hashes = {}
for path in sorted(glob.glob("approved/*.jpg")):      # only human-approved files
    with open(path, "rb") as f:
        r = requests.post(f"{API}/{ACT}/adimages", timeout=120,
                          files={"filename": (os.path.basename(path), f)},
                          data={"access_token": TOKEN}).json()
    if "error" in r:
        raise RuntimeError(r["error"])
    for name, info in r["images"].items():
        hashes[name] = info["hash"]
json.dump(hashes, open("image_hashes.json", "w"), indent=1)
print(len(hashes), "images uploaded")

跨帳戶使用同一批素材時,可用 copy_from 指定來源帳戶與 hash,而不是重新上傳;前提是你的應用使用者有權讀取來源帳戶的廣告創意(來源帳戶 ID 不帶 act_ 前綴)。

第 3 步:組合文案與圖片建立創意

創意以 object_story_spec 描述,包含粉絲專頁、連結、文案、圖片 hash 與 CTA(建立廣告創意)。建立請求帶冪等鍵,逾時重試不會產生重複創意(冪等請求):

# make_creatives.py (excerpt) - copy.csv x image_hashes.json -> creatives
import csv, json, os
from meta_api import call, key, ACT
RUN = "2026-11-16-tw-batch"
hashes = json.load(open("image_hashes.json"))
for row in csv.DictReader(open("copy_approved.csv", encoding="utf-8")):
    spec = {"page_id": os.environ["META_PAGE_ID"],
            "link_data": {"message": row["primary_text"], "name": row["headline"],
                          "link": row["link"], "image_hash": hashes[row["image_file"]],
                          "call_to_action": {"type": row["cta"]}}}
    c = call("POST", f"{ACT}/adcreatives",
             data={"name": f"TW | {row['variant_id']}", "object_story_spec": json.dumps(spec)},
             idem_key=key(RUN, "creative-" + row["variant_id"]))
    print(row["variant_id"], c["id"])

v27.0 起,若創意未設定產品展示,Meta 可能在高信心配對時自動加入 Product showcase;不需要時可在 degrees_of_freedom_spec 選擇退出(v27.0 changelog)。

第 4 步:在沙盒裡讓 Codex 改程式

交給 Codex 改程式時用 workspace-write 沙盒;只有你自己執行上傳指令時才會連到 Meta。Codex 的沙盒與核准設定見 Codex 權限、沙盒與合規。

# pip install openai-codex   (Python 3.10+)
from openai_codex import Codex, Sandbox

with Codex() as codex:
    thread = codex.thread_start(sandbox=Sandbox.workspace_write)   # no full access
    result = thread.run(
        "Read AGENTS.md. Add a --dry-run flag to create_paused.py that prints "
        "the payloads instead of calling the API, plus tests. Do not call the live API.")
    print(result.final_response)

第 5 步:監控素材疲勞

訂閱 creative_fatigue Webhook 後,廣告的素材疲勞等級改變時 Meta 會推送 LOW/MEDIUM/HIGH(creative_fatigue)。收到 HIGH 時,把該廣告的近期頻次、CTR、成本整理成清單,交由投手決定是否替換素材,再走一次審核 → 上傳 → 建立創意的流程。

限流與批次大小

同一廣告帳戶寫入請求每秒不超過 100 次;遇到 613 或 80000 系列錯誤時退避(Rate limiting)。素材多時建議分批,每批記錄結果,方便從中斷處續傳。

熊貓出海如何用 Claude、Codex 與 Facebook 廣告帳戶提升客戶投放效率

本文主角是 Codex,但在實際服務中,熊貓出海會把 Claude、Codex 與 Facebook 企業廣告帳戶組合使用,協助出海企業更快完成「開戶 → 建立結構 → 上素材 → 看數據 → 調預算」這套重複工作,讓投放團隊把時間留給策略與素材判斷。

  • 廣告帳戶:使用企業自己的 Facebook 廣告帳戶,或透過熊貓出海開戶服務合規開通的企業戶;帳戶歸企業所有,不出租、不共享。
  • Claude:適合閱讀長文件與報表、撰寫投放規劃與文案初稿、透過 Meta 廣告 MCP 以暫停狀態起草廣告結構、依規則排查異常。
  • Codex:適合撰寫與維護自動化腳本(Marketing API、Insights 報表、批次上傳、預算規則),在沙盒中執行並接入排程或 CI。
  • 人工把關:所有會花錢的動作(啟用廣告、提高預算)都由投手審核後執行;Meta 廣告政策與素材合規由人工最終確認。

這是服務能力說明,不涉及任何價格或回饋承諾;我們也不是 Meta、Anthropic 或 OpenAI 的官方合作夥伴。開戶與代操流程請見 Facebook 廣告代操與海外開戶(熊貓出海服務頁)。

常見問題

Codex 會幫我做圖嗎?

本文流程中 Codex 負責寫上傳與組合的程式;圖片由設計團隊或你選定的工具產出,經人工審核。

上傳失敗怎麼續傳?

以 image_hashes.json 記錄已完成的檔案,重跑時跳過即可。

影片素材也能這樣做嗎?

影片走不同的上傳端點與流程,本文只涵蓋圖片。

同一張圖可以用在多個廣告帳戶嗎?

可以用 copy_from 從來源帳戶複製,需具備讀取來源帳戶創意的權限。

批次建立的廣告會自動上線嗎?

不會,我們的流程中廣告一律以暫停狀態建立,由人工啟用。

合規說明:本文所有自動化都應只用於企業自有或已獲正式授權的廣告帳戶、粉絲專頁與像素,透過 Meta 官方 Marketing API、Ads MCP 伺服器或 Ads CLI 接入,使用企業管理平台中的系統使用者與最小權限,遵守 Meta 速率限制與《廣告刊登準則》,並在任何會產生花費的動作前保留人工審核。熊貓出海不販售、出租、共享或轉讓廣告帳戶、企業管理平台或 API 金鑰,不協助規避廣告審查、地區限制、KYC、企業驗證或付款管控,也不是 Meta、Anthropic 或 OpenAI 的官方合作夥伴。Claude 與 OpenAI 服務僅提供給支援國家/地區的客戶,請由在支援地區合法設立並實際營運的主體開通並負責。

延伸閱讀

聯絡熊貓出海:Facebook 開戶 + AI 自動化投放

請告訴我們公司登記地、產業、目標國家、到達網頁連結與預估月預算,以及想先自動化哪一段(建立結構、素材、報表或預算規則)。我們先做資格與素材預審,再協助開通合規的 Facebook 企業廣告帳戶,並用 Claude、Codex 建立在您自有帳戶上執行的自動化流程。我們不販售、出租或共享任何廣告帳戶。

WhatsApp:+852 5904 8602Telegram:@PANDA0134WeChat/微信:szcwh99

熊貓出海 WeChat QR 微信:szcwh99

官方來源

以上官方頁面皆於 2026-11-16 查閱。API 版本、工具名稱與權限要求會變動,請以官方頁面為準。

本文来自网络,不代表熊猫出海立场。转载请注明出处: https://www.pandawm.com/blog/codex-facebook-ads-creative-bulk-upload-adimages-zh-tw.html
上一篇
下一篇

作者: 熊猫出海编辑团队

熊猫出海(PandaWM)编辑团队,来自香港出海服务商熊猫出海,专注 Facebook、TikTok、Google 等海外广告开户与代投,以及 GEO/AI 搜索优化、多语言独立站建设。有Facebook白名单牌照户、TikTok加白户、Google G2认证户等核心资源 。

为您推荐

发表回复

联系我们

联系我们

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部