跳到主要內容
Tessera Academy
會員登入

教學・免費

Higgsfield API 新手教學：5 個步驟開 API key，用 Codex 做出自己的 AI App

Scott Lai・更新於 2026 年 10 月 24 日

Higgsfield API 新手教學封面

簡單答案：用折扣連結開一個 Higgsfield API 帳戶，在 Dashboard 按「Create API key」建立並複製 key，儲值之後，把 key 和下面的 Prompt 一起貼給 Codex（或 Claude），說出你想做的 App，AI 就會開始幫你寫。整個過程不需要自己寫程式，大約 10 分鐘就能開始。截至 2026 年 10 月 24 日，Genjutsu 的 API 價格由每秒約 0.16 美元起（已計入官方的 50% 折扣）。

很多賺錢的 AI App，背後的 AI 其實都不是自己做的。它們做的只有一件事：用 API 把別人已經做好的 AI 接進自己的 App，再包裝成一個大家想用的產品。

Higgsfield 官方的 Quickstart 是寫給工程師看的，要用終端機輸入指令。這一頁改寫成新手版本：每一步都有截圖，最後附上我在影片中示範的 Prompt，複製貼上就可以開始。

如果你只是想自己生成圖片和影片，不打算做 App，其實不需要 API，直接用 higgsfield.ai 網站就可以，Higgsfield 全功能完整教學 由第一張圖開始講起。

開始之前，你需要準備

  • 一個 Higgsfield API 帳戶：用下面步驟 1 的連結開戶，所有模型有 30 天折扣
  • Codex 或 Claude：負責幫你寫程式的 AI。影片中示範的是 Codex，Claude（Claude Code）也一樣可以，文章後半有我用 Claude Code 做的例子
  • 少量儲值：API 是用一次收一次錢，生成之前要先在帳戶儲值

步驟 1：用折扣連結開帳戶

打開 Higgsfield API 折扣連結，用 Google 或 Email 註冊。這條連結會帶你到 Higgsfield 的官方 API 平台（open.higgsfield.ai），並自動套用 30 天的全模型折扣。

第一次登入時，平台會問你兩條簡單問題：

  1. How will you be using Open Higgsfield? 自己試用選「For personal use」，公司用選「For my company」
  2. What do you want to do first? 選「Build with Code」

最後一頁「How did you hear about us?」可以略過，直接按「Next」就會進入 Dashboard。

步驟 2：建立 API key

在 Dashboard 右上角按 「Create API key」。

Higgsfield API Dashboard 右上角的 Create API key 按鈕

在「API key name」輸入一個容易認的名字，例如「APP」，然後按 「Create key」。到期日（Set expiration date）可以不用設定。

Create API key 視窗，名稱輸入 APP

步驟 3：馬上複製 API key

建立之後會出現「Save your API key」視窗，按 「Copy API key」 複製。

Save your API key 視窗，下方有 Copy API key 按鈕

這裡有兩點要留意：

  • API key 只會顯示一次。關掉視窗之後就不能再看，所以要先複製，暫時貼在只有你看得到的地方（例如密碼管理工具）
  • 複製出來的 key 中間有一個冒號「:」，前半是 key ID，後半是 secret。整條一起交給 AI 就可以，不要拆開，也不要刪走冒號

視窗下方還有一個「Coding agent」設定 Prompt，是 Higgsfield 官方寫給 AI 編程工具的說明，也可以一併複製給 Codex 參考。

步驟 4：先儲值

API 是按用量收費的，帳戶結餘是 $0 的話，AI 寫好的 App 也生成不到東西。在左邊選單按 「Top up」，或在 Dashboard 按 「Add funds」 儲值。

第一次試建議先放少量金額。以 Genjutsu 為例，官方價格頁（2026 年 10 月 24 日查閱）顯示最低每秒約 0.16 美元，即 10 秒影片大約 1.6 美元；這是計入 50% 折扣後的價錢，原價約每秒 0.32 美元，登入後顯示的價錢可能略有不同。先用低解像度試好效果，再決定要不要用 1080p。實際價錢以 官方價格頁 當下顯示為準。

步驟 5：把 API key 交給 Codex，開始做 App

打開 Codex（或 Claude），貼上下面的 Prompt，在最後貼上你剛才複製的 API key，然後送出。

在 Codex 輸入用 Higgsfield API 做服裝店換衫 App 的 Prompt
影片示範：服裝店換衫 App
用 Higgsfield API 的 Genjutsu（Object Swap，endpoint：higgsfield/genjutsu/object-swap/v1.0），幫我做一個服裝店用的換衫 App：

1. 店主上傳一條模特兒影片（4 至 30 秒）和最多 8 張新一季衣服的相片
2. App 把影片中的衣服換成上傳的新衣服，動作、鏡頭和背景保持不變
3. 生成完成後可以直接預覽和下載影片

要求：
- API key 只放在伺服器端的環境變數，不要寫進網頁前端
- 先用 480p 測試，確認效果後才提供 1080p 選項
- 介面簡單，一個上傳區、一個「開始換衫」按鈕
- 一步一步告訴我需要做甚麼，我不會寫程式

我的 Higgsfield API key 是：

送出之後，Codex 會先查閱 Higgsfield 的 API 文件，再開始建立檔案。過程中它可能會問你一些問題（例如要用哪種網頁框架），不肯定的話直接回答「用最簡單、最適合新手的做法」就可以。

想做其他 App，保留這個結構，只換「幫我做一個…」和第 1 至 3 點就行。例如：

改做 Marketing 用的 App
用 Higgsfield API 的 Genjutsu，幫我做一個 Marketing 用的 App：用戶上傳一條社交媒體上爆紅的短片，再上傳一張自己產品的相片，App 就把片中的主角物件換成這件產品，其他畫面保持不變

我自己做的例子：潮牌試身 App

影片裡示範的是 Codex。為了看看這套方法可以做到多完整，我也用 Claude Code 照樣做了一個：一間潮牌網店，客人選一件衣服按一下，衣服就會穿到我身上，還可以 360 度轉身，按一下人物就會走一圈，看衣服動起來的樣子。

潮牌試身 App 的三個畫面：換衫前、Genjutsu 生成中、換上新衣服之後

背後的做法其實只有三步：

  1. 先做模特兒的「底片」：用我自己的照片做參考，生成兩條我穿純黑 T 恤的影片，一條原地轉一圈，一條走幾步再轉身
  2. 用 Genjutsu 換衫：每件衣服交給 Genjutsu Object Swap，把底片裡的黑色 T 恤換成店裡那一件，臉、動作和背景都保持不變
  3. 把影片變成可以玩的畫面：App 把轉身影片拆成 72 格，手指左右拖就能 360 度看；按一下人物就播放走路影片

因為每件衣服都用同一條底片，所以轉身的動作完全一樣，背後的印花也會在轉到背面時出現：

同一件 T 恤的正面、側面、背面和另一側，背面印花清楚可見

這是我給 Claude Code 的 Prompt 精簡版，想做類似的 App 可以直接改來用：

我的例子：潮牌試身 App（Claude Code）
幫我做一個街頭服飾品牌的網店 Demo，加入「AI 試身」功能：

1. 網店有首頁、分類頁和商品頁，商品名稱、價錢和圖片從我提供的網站整理出來
2. 每件衣服都有「試身」按鈕：用 Higgsfield API 的 Genjutsu（Object Swap，endpoint：higgsfield/genjutsu/object-swap/v1.0），把模特兒影片裡的衣服換成這一件
3. 模特兒可以 360 度轉身（手指左右拖動），按一下人物就會走路
4. 以手機直式畫面為主，動畫要順

要求：
- 開始之前先讀 Higgsfield 官方 API 文件，確認目前的 endpoint 和參數
- API key 只放在伺服器端的 .env 檔案，前端不可以看到
- 每次生成之前先顯示預估費用，先用 480p 測試
- 沒有 API key 時，要有示範模式，可以播放已經生成好的結果

做的過程中我也踩了幾個坑，分享給你參考：

  • 模特兒一開始不像我：只靠 AI 從零畫，臉會被畫得比較瘦、比較長。後來改用真人照片（正面全身照加三個角度的臉部特寫）做參考，才像回自己
  • 480p 在手機上會糊：480p 很適合用來試效果，但放到手機全螢幕就看得出模糊。確認方向沒問題之後，再用 1080p 做最後版本
  • Genjutsu 偶爾會自己拉近鏡頭：有時輸出會只剩上半身。Prompt 第一段要寫明「保持原片構圖、全身入鏡、不要放大」，生成之後每一條都要自己看一次
  • 生成按影片長度收費：每件衣服要換兩條影片（轉身和走路），所以先用少量衣服試做，算好成本再決定做多少件

API key 要放在哪裡？

這是最多人問的問題。簡單來說：API key 只可以放在伺服器端，不可以放在任何別人看得到的地方。

  • 可以放：伺服器的環境變數（通常是一個叫 .env 的檔案）。Codex 問你 key 要放哪裡時，選伺服器端或環境變數
  • 不要放：網頁前端或手機 App 的程式碼裡面。只要有人打開 App 的程式碼，就能偷走你的 key，用你的額度生成
  • 不要分享：不要貼到公開的對話、群組、截圖或者 GitHub

萬一 key 外洩了，馬上到平台左邊選單的 「API keys」，把那條 key 刪除，再建立一條新的就可以。舊的 key 刪除之後就會即時失效。

Genjutsu API 的基本限制

用 Genjutsu 做 App 之前，先知道這幾個官方限制，可以少走很多冤枉路：

  • 影片長度：最少 4 秒，超過 30 秒會被裁剪到 30 秒
  • 參考相片：每次 1 至 8 張
  • 影片解像度：每格最少約 41 萬像素，480p 直式（480×854）或以上就足夠
  • 兩種模式：Object Swap 換掉指定的人、衣服、物件或場景；Motion Transfer 把一段影片的動作套到新角色身上

想看 Genjutsu 實際效果和 Prompt 寫法，可以參考 AI 換人換車組合 Prompt；Motion Transfer 的例子，可以看 用 Higgsfield 複製跑車運鏡的教學。

API、CLI、MCP 應該用哪一個？

Higgsfield 有三種讓 AI 工具使用它的方法，收費方式不一樣，選錯了會多花錢：

方法 收費方式 適合誰
API（open.higgsfield.ai） 預先儲值，用多少扣多少 想做 App，給自己的客人使用
CLI＋官方 Skills 扣 Higgsfield 方案的 credits 用 Claude Code、Codex 自己批量生成內容
MCP 連接器 扣 Higgsfield 方案的 credits 在 Claude、ChatGPT 對話中直接生成

簡單來說：東西是給別人用的，就用 API；是給自己用的，就用 CLI 或 MCP。CLI 的安裝和 8 個官方技能，可以看 Higgsfield 官方 Skills 教學；MCP 在 Claude 的玩法，例如一句 Prompt 做出 What if 動畫，可以看 Higgsfield Content Factory 教學。

如果你想了解 Codex、Claude Code 這類會自己動手做事的 AI 是甚麼，可以先讀 AI Agent 是甚麼。

常見問題

Q：完全不會寫程式，真的可以做到嗎？ A：可以開始，但要有耐性。Codex 和 Claude 會幫你寫程式碼，你要做的是清楚說出想要甚麼，並跟著它的指示操作。遇到錯誤訊息，直接整段複製貼回去問它就可以。

Q：Higgsfield API 和 higgsfield.ai 網站有甚麼分別？ A：higgsfield.ai 是給人直接在網頁上生成影片的工具；API（open.higgsfield.ai）是給 App 接駁用的，讓你把同樣的模型放進自己的產品，再提供給你的用戶使用。

Q：我不知道 API key 要放在哪裡，怎麼辦？ A：試試這三招：

  • 直接問 Codex：「API key 應該放在哪裡才安全？請幫我設定」
  • 確認 key 放在 .env 這類環境變數檔案，而不是網頁程式碼裡
  • 如果已經不小心公開了，到「API keys」頁面刪除，再建立一條新的

仍然解決不到，可以在 IG 私訊我 @0xscottlai.eth。

Q：Higgsfield API 要多少錢？ A：API 是預先儲值、按用量收費的。截至 2026 年 10 月 24 日，Genjutsu 在官方價格頁顯示最低每秒約 0.16 美元（已計入 50% 折扣，原價約 0.32 美元），解像度越高越貴，實際以官方價格頁為準。

Q：做出來的 App 一定可以賺錢嗎？ A：不一定。API 是用一次收一次錢，定價要先計算好成本，也要有人願意用。這一頁教你的是起步的方法，能否賺錢取決於你怎樣做好產品和推廣。

想有系統地學會用 AI？

如果想由零開始學會寫指令、追問修改和查證答案，START AI 新手線上課程用十集廣東話短片，一步一步帶你上手。

價錢和介面以 Higgsfield 官方當下版本為準。

本文資料更新日期：2026 年 10 月 24 日。