需要 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_u… |
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-sy… |
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_st… |
generate_speech | 文字转语音（TTS）：朗读传入的文字并返回音频文件。模型：list_models 加 mode=text_to_speech（MiniMax 2.8 的保加利亚语最好；ElevenLabs v3 — 声音最有表现力）。每个模型的声音和选项看 describe_model。异步：返回 job_id → check_st… |
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。如果你够不到文件（照片只在聊天里，没有路径）→ ge… |
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 | 用户的付款 — 买了什么、什么时候买的、多少钱、用什么方式。遇到'我付过什么'、'把付款给我'、'发票'时用。 |
更新于