需要 API 金鑰嗎？
不需要。你把連接器的位址加進去，助手會帶你用 genkiki.com 的帳號登入，就這麼簡單。
MCP（Model Context Protocol）是 AI 助手連接外部服務的方式。genkiki.com 有自己的 MCP 伺服器：你在 Claude、ChatGPT 或其他用戶端裡把它加為連接器，用自己的帳號登入，之後助手就會替你生成和查詢 — 用的是和工作室裡一樣的模型、點數和素材庫。
同一個連接器網址在哪裡都能用：ChatGPT, Claude, Claude Code, Cursor, OpenClaw, Hermes。助手能看到你的模型、積分和生成 — 透過你自己的帳號，不需要 API 金鑰。
連接器網址： https://genkiki.com/ai/mcp。在 Claude Code 裡： claude mcp add --transport http generiram https://genkiki.com/ai/mcp。帶複製按鈕的詳細步驟在你的個人資料裡： /account/mcp/.
這些是助手可以代你呼叫的操作。每次生成花的點數和在工作室裡一樣，開始之前就能看到價格。
| 工具 | 作用 |
|---|---|
generate_image | 按文字提示詞生成圖像，並以圖片形式返回（同步）。你可以用名字指定具體模型（參數 'model' — 來自 list_models 的鍵，例如 'recraft_v4_v1'、'cheap_image_v1'）；不指定就用預設模型。 |
edit_image | 按文字提示詞編輯/轉換輸入的照片（image-to-image）。傳入 image_url + 說明要改什麼的 prompt。按名字指定模型（mode='image_to_image'，例如 'nano_banana_i2i_v1'）。📎 是使用者自己的照片（聊天裡附上的/手機裡的）？別要檔案路徑 — 呼叫 get_… |
generate_video | 按文字提示詞啟動影片生成。影片要花時間，所以會立刻返回 job_id 和狀態 'started' — 之後用 job_id 呼叫 check_status 去取做好的影片。你可以用名字指定模型（來自 list_models，mode='text_to_video'，例如 'kling30_std_t2v_v1'、's… |
animate_image | 把輸入的照片動畫成影片（image-to-video）。傳入 image_url（或過去某次生成的 source_job_id）+ 可選的 prompt 說明要什麼動作/場景。影片慢 → 返回 job_id；之後用 check_status。按名字從 list_models 指定模型（mode='image_to_v… |
transform_video | 影片 → 影片：對輸入影片做轉換/重塑風格/放大/去背景。傳入 video_url + 可選 prompt。非同步 → job_id，之後 check_status。可選 reference_image_urls。按名字從 list_models 指定模型（mode='video_to_video'，不是 lip-s… |
reference_video | 參考素材 → 影片：按提示詞 + 參考的照片/影片/音訊生成影片。🧑🤝🧑 做角色一致的連續劇最合適 — Seedance reference 能讓同一個角色在各個片段之間保持不變。傳入 prompt + image_urls（角色的照片）和/或 video_urls 和/或 audio_urls + model。… |
lip_sync | Lip-sync：讓輸入影片裡的嘴型對上音訊（kling_lipsync_text_v1 也可以用文字+聲音）。傳入 video_url + audio_url（或 text+voice_id）+ model。非同步 → job_id，之後 check_status。 |
dub_video | 把輸入影片配音/翻譯成另一種語言。傳入 video_url + language（例如 HeyGen 用 'Bulgarian'，ElevenLabs 用 'bg'）+ model（heygen_translate_v1 或 elevenlabs_dubbing_v1）。非同步 → job_id，之後 check_s… |
generate_speech | 文字轉語音（TTS）：朗讀傳入的文字並返回音訊檔案。模型：list_models 加 mode=text_to_speech（MiniMax 2.8 的保加利亞語最好；ElevenLabs v3 — 聲音最有表現力）。每個模型的聲音和選項看 describe_model。非同步：返回 job_id → check_s… |
upscale_video | 用 Topaz 把輸入影片放大（提高解析度）。傳入 video_url 或 source_job_id（來自 list_my_generations 的過去影片編號）。非同步 → job_id，之後 check_status。 |
| 工具 | 作用 |
|---|---|
list_models | 返回可以透過 generiram 工作室生成的全部可用模型（圖片、影片、lip-sync、配音等）。呼叫它，就能知道有哪些模型、它們要什麼輸入，以及各自要花多少積分。欄位：model（傳參用的鍵）、label、mode、input（要什麼）、prompt_max_chars、credits（1 次生成的積分價格 — … |
describe_model | 返回某個具體模型的準確選項：必填的輸入、允許的取值、提示詞長度上限、檔案大小上限、時長；lip-sync/配音還會給出聲音和語言。想用模型特有的選項時就呼叫它。 |
model_price | 用某個模型做一次生成要花多少積分 — 在開跑之前。遇到'這要花我多少錢'、'哪個更便宜'時用，而且每次生成之前都要用，好把價格告訴人並等他同意。 |
site_info | genkiki.com 的即時查詢 — 當場讀資料庫（沒有任何寫死的東西）。用它來給出正確的建議：'你們能做什麼'、'方案/套餐是什麼樣的'、'你們有什麼相冊'、'有什麼新東西'、'我的積分有效到什麼時候 / 我的檔案保存多久 / 我有名額嗎'。💡 賺錢：如果人在琢磨怎麼賺積分/賺錢，或者抱怨積分少/快用完了 — 就… |
| 工具 | 作用 |
|---|---|
check_status | 查看已啟動的生成的狀態（例如來自 generate_video 的影片）。傳入 job_id。返回它是不是好了以及結果的連結，或者說還在處理。 |
list_my_generations | 返回使用者的歷史 — 他最近做好的生成（圖片/影片），帶編號（job_id）、模型、提示詞和日期。當使用者說'給我看最近的'、'拿那隻貓'、'把那個角色接著做'時就用它。編號之後作為 source_job_id 傳給 edit_image/animate_image/upscale_video。 |
| 工具 | 作用 |
|---|---|
get_upload_link | 🔴 當使用者想用自己的照片/影片時 — 你的第一步就是這個工具。你看得見附上的檔案，但沒辦法把它傳給這些工具 — 它們要的是網址。這個工具返回一條短連結：使用者打開它（手機上也行），上傳檔案，然後回到對話裡。接著你呼叫 list_my_uploads，取到編號/網址，作為 image_url/video_url 傳下… |
upload_from_url | 從網路上的網址下載圖片/影片/音訊，放進使用者的庫裡。當媒體已經在線上時就用它。返回我們網域下的編號和網址，可以直接用作 image_url/video_url。使用者裝置上的檔案請用 get_upload_link。 |
upload_base64 | 🔴 直接（base64）上傳使用者的檔案 — 不用拿連結去麻煩人。當你自己能讀到檔案時先用它（Claude Desktop/Code 有磁碟權限：把檔案編成 base64 傳進來）。返回一個網址，作為 image_url/video_url 傳下去。最大 25 MB。如果你搆不到檔案（照片只在聊天裡，沒有路徑）→ g… |
list_my_uploads | 使用者上傳過的檔案（不是生成 — 那些看 list_my_generations）。返回編號、類型、名字和網址。從這裡取 image_url/video_url 給別的工具。在 get_upload_link 之後呼叫它，看看他上傳了什麼。 |
delete_upload | 按編號（來自 list_my_uploads）從使用者的庫裡刪除已上傳的檔案。遇到'刪掉它'、'把那張照片拿走'時用。生成不從這裡刪。 |
| 工具 | 作用 |
|---|---|
list_album_themes | 📖 相冊（也叫「矩陣」）：現成的主題，客戶照片上的臉會進到每一頁 — 「小王子」、「漫畫肖像」、「生日」、「恐龍」… 返回各個主題以及按頁數的價格。遇到'你們有什麼相冊'、'我想給孩子做本相冊'、'照片書'、'用照片做的禮物'時用。相冊和單次生成是兩回事。 |
describe_album_theme | 關於一個相冊主題的詳細說明：要幾張照片、有哪些欄位（封面文字、年份、編號）、有沒有地點可選，以及每種允許的頁數的準確帳目 — 生成次數、頁張數、積分和歐元價格。在 order_album 之前呼叫它，這樣你才知道要問客戶什麼、一共多少錢。 |
order_album | 🔴 訂購相冊 — 會花積分。呼叫之前先問客戶確認，並把價格告訴他（從 describe_album_theme 拿）。需要已上傳照片的編號（list_my_uploads；沒有就給 get_upload_link）。照片的順序有講究：雙主角的主題裡，第一張是其中一個人，第二張是另一個。相冊做得久；之後用 check_… |
check_album | 相冊做到哪一步了：一共多少頁、已經好了多少，以及每一頁的狀態。遇到'相冊好了嗎'、'做到哪了'時用。相冊每頁要做幾分鐘。 |
my_albums | 使用者的相冊 — 編號、主題、狀態、頁數。遇到'我的相冊'、'以前那本相冊'時用。 |
| 工具 | 作用 |
|---|---|
check_balance | 返回使用者帳戶上的可用積分（以及這條連線今天還剩多少次生成）。當使用者問'我有多少積分'、'夠不夠用'之類的問題時就呼叫它。 |
my_plan | 使用者的方案：是哪一個、走到什麼時候、會不會續訂、有沒有已安排的更換，以及各個錢包裡有多少積分（連同各自的期限）。遇到'我是什麼方案'、'我什麼時候到期'、'新方案什麼時候生效'、'我的積分什麼時候過期'時用。 |
list_plans | 在售的訂閱方案 — 名字、月付/年付價格、積分。遇到'你們有什麼方案'、'訂閱多少錢'、'都包含什麼'時用。 |
list_credit_packages | 一次性購買的積分套餐 — 多少積分、價格、贈送、有效期。遇到'我想買積分'、'1000 積分多少錢'時用。 |
get_payment_link | 💳 網站結帳頁的連結。聊天裡不做付款 — 信用卡資料不在對話中輸入。給出連結，人照常去付（信用卡、PayPal、Revolut、銀行）。遇到'給我買積分'、'我想升級方案'時用。不要索取卡號。 |
my_transactions | 積分餘額的變動 — 積分花到哪去了、什麼時候進來的。遇到'我的積分去哪了'、'我都花了什麼'時用。 |
my_payments | 使用者的付款 — 買了什麼、什麼時候買的、多少錢、用什麼方式。遇到'我付過什麼'、'把付款給我'、'發票'時用。 |
更新於