API 與 MCP 伺服器
用一把 API 金鑰，從 Claude、Cursor 或自己的腳本生成：同樣的模型、同樣的點數，失敗一樣退款。
畫布之外的 Imaginode
畫布能生成的一切，在畫布之外同樣做得到：一組 REST API 與一台 MCP 伺服器（Model Context Protocol），讓 AI 代理或腳本用您的帳號產出圖片與影片。呼叫會扣您餘額裡的點數，價格與畫布相同，生成失敗一樣自動退款。
MCP 是讓 AI 助理（Claude、Cursor 以及許多其他工具）使用外部工具的標準。接上 Imaginode 之後，您的助理可以在對話中途生成一張圖、替它正在寫的文章配圖，或是產出自動化工作流所需的視覺素材。
建立 API 金鑰
前往您的個人檔案，找到「API 金鑰」區塊。替金鑰取個名字（「Claude Code」、「部落格腳本」等）再建立：imk_… 這串密鑰只會顯示一次，請立刻複製起來。最多五把有效金鑰，隨時可以一鍵撤銷；撤銷的金鑰立刻失效。
建立金鑰需要通過電子郵件驗證，每把金鑰限制每分鐘 10 次生成：工作起來綽綽有餘，但就算某個代理失控，也不至於意外把餘額用光。
連接 MCP 伺服器
伺服器位址是 https://imaginode.ai/api/mcp（Streamable HTTP 傳輸）。認證方式是把金鑰放進「Authorization: Bearer imk_…」標頭。在 Claude Code 裡一行指令就好：claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer 您的金鑰"。在 Claude.ai 或 Cursor 裡，用同樣的位址與同樣的標頭新增一個自訂連接器。
對外提供四個工具。list_models 回傳型錄與以點數計的價格。generate_image 生成一張圖並等待結果：URL 直接回傳。generate_video 啟動一支影片並回傳追蹤用的識別碼。get_generation_status 追蹤一次生成，直到拿到最終的 URL。
直接呼叫 REST API
寫腳本的話，三個端點就夠了。GET /api/models 列出模型、可用選項與價格，不需要認證。POST /api/generate 啟動一次生成：JSON 裡放 model、prompt 與該模型的選項（duration、resolution、aspectRatio、audio、imageUrls），金鑰放在 Authorization 標頭，回應會包含 requestId、cost 與您的新餘額。GET /api/generate/status?requestId=… 會先回傳 running，接著是帶有輸出 URL 的 completed，或是帶有退款的 failed。
輸入圖片（imageUrls）必須是存放在您 Imaginode 帳號裡的媒體：先匯入您的媒體庫，或是直接沿用先前某次生成的 URL。
最佳實務
先用便宜的模型（Flux Schnell，1 點）把提示詞調到位，再換上高階模型。影片則每 30 秒查一次狀態：一般抓 1 到 5 分鐘，長一點的生成最多 30 分鐘。確切的花費在啟動當下就會回傳，比結果還早。
金鑰是機密：不要 commit 進版本庫，也不要外流。只要有一絲疑慮，就到個人檔案頁撤銷它，再建一把新的。