給開發者的 MCP 伺服器

為 Claude Code、Cursor、Codex 與任何 MCP 用戶端提供單一端點。以 API 金鑰驗證，依模型 ID 呼叫任何 PopNow 模型，每筆扣款都以 USD 確認。

端點

採用 Streamable HTTP，無需安裝。以 Bearer 權杖的形式傳送 API 金鑰。此金鑰的模型允許清單、IP 允許清單與花費上限，與 REST API 完全相同。

僅需 API 金鑰，無需登入帳號
以 USD 從 API 餘額扣款
每分鐘 240 次請求、20 個新任務

https://api.popnow.ai/api/v1/mcp

curl -X POST https://api.popnow.ai/api/v1/mcp \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

連接你的程式代理

將金鑰保存在 POPNOW_API_KEY 中。切勿貼到提示詞裡，也不要提交到程式庫。

claude mcp add --transport http popnow-api https://api.popnow.ai/api/v1/mcp \
  --header "Authorization: Bearer $POPNOW_API_KEY"

{
  "mcpServers": {
    "popnow-api": {
      "url": "https://api.popnow.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:POPNOW_API_KEY}"
      }
    }
  }
}

.cursor/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "popnow-api-key",
      "description": "PopNow API key (sk-popnow-...)",
      "password": true
    }
  ],
  "servers": {
    "popnow-api": {
      "type": "http",
      "url": "https://api.popnow.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:popnow-api-key}"
      }
    }
  }
}

.vscode/mcp.json

[mcp_servers.popnow-api]
url = "https://api.popnow.ai/api/v1/mcp"
bearer_token_env_var = "POPNOW_API_KEY"

~/.codex/config.toml

{
  "mcpServers": {
    "popnow-api": {
      "serverUrl": "https://api.popnow.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:POPNOW_API_KEY}"
      }
    }
  }
}

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "popnow-api": {
      "type": "http",
      "url": "https://api.popnow.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${POPNOW_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "popnow-api": {
      "command": "npx",
      "args": [
        "-y",
        "@popnow/mcp"
      ],
      "env": {
        "POPNOW_API_KEY": "sk-popnow-...",
        "POPNOW_MCP_URL": "https://api.popnow.ai/api/v1/mcp"
      }
    }
  }
}

適用於只能執行本機伺服器的用戶端：開源橋接程式會把 stdio 轉送到此端點。

工具

具名工具會採用合理的預設值。create_task 可以用模型的準確 ID 執行任何模型。

`create_task`	用模型的準確 API ID 執行任何模型，並傳入該模型自己的輸入欄位，呼叫方式與 POST /api/v1/jobs/createTask 相同。
`create_image · create_video · create_music · create_speech`	附帶預設值的具名工具，另有 edit_image、apply_effect、remove_background、upscale、add_sound，以及 extend_video、relight_photo 等單一用途工具。
`list_models`	準確的模型 ID、各模型的輸入欄位及其 USD 價格。
`get_task · list_tasks`	追蹤任務進度，並列出以此金鑰建立的近期任務。
`check_balance`	此金鑰錢包中可用與保留的 USD 金額。
`compose_video`	將先前的結果剪成一支 MP4，可加入音樂、語音與字幕。免費。
`find_skills · install_skill`	挑選技能套件，然後取得其操作手冊、下載連結與安裝指令。
`run_my_recipe · get_recipe_run · resume_recipe_run`	執行你儲存的配方與工作流程。

每筆扣款都以 USD 確認

1報價
不帶 max_usd 呼叫付費工具。你會取得 cost_usd 與 available_usd，此時不會扣款。
2確認
向使用者展示價格。使用者同意後，以相同參數再次呼叫該工具，並將 max_usd 設為報價中的 cost_usd。
3執行
任務開始時保留相應金額，完成後結算。任務失敗則釋放保留的金額。

API 餘額不足？請前往 API 主控台儲值。

從舊位址遷移

傳送到 https://api.popnow.ai/mcp 的 API 金鑰將持續有效至 2027年1月31日，回應帶有 Deprecation 與 Sunset 標頭。在那之前，請把你的設定改為上方的端點。

常見問題

需要安裝任何東西嗎？

不需要。這是遠端伺服器，只要加入位址和你的 API 金鑰即可。開源橋接程式僅適用於只能執行本機伺服器的用戶端。

可以呼叫哪些模型？

PopNow API 目錄中向 MCP 開放的圖片、影片、音樂和語音模型。list_models 會列出準確的 ID 與輸入欄位。

如何計費？

以 USD 計價，從該金鑰對應的 API 餘額中扣除，價格與 REST API 相同。每次付費呼叫都需先確認 max_usd。

任務失敗會怎樣？

保留的金額會全額釋放。get_task 會顯示失敗原因。

開始串接 PopNow API

一組金鑰呼叫所有模型，依需求為 API 美元餘額儲值，每次執行前提供準確報價。

取得 API 金鑰在 Playground 中試用

只想在 ChatGPT 或 Claude 中使用 PopNow？請前往 PopNow for ChatGPT & Claude