API-KEY 配置

适用场景

API-KEY 页面用于保存聊天、MidJourney 和 Suno 文生歌的上游凭证。AI 生图、视频、即梦和 AIPPT 使用各自配置页的凭证，不要在这里创建“绘图”或“视频”类型。

前置条件

先在上游平台创建令牌。本文以 极客 API 中转站 为例；真实令牌只粘贴到后台，不要写入文档或公开截图。

登录中转站后进入 控制台 → 令牌管理，点击 添加令牌。填写名称，按需设置有效期、额度、模型和 IP 限制；首次接入建议不限制模型，验证完成后再收紧权限。

中转站创建令牌表单

后台入口

登录后台，进入 API-KEY（/admin/apikey），点击 新增。

新增 API-KEY 表单

截图中的名称、API URL 和令牌均为填写示例；sk-example-... 不是可调用的真实密钥。

操作步骤

  1. 填写一个能识别用途的名称，如 中转站-聊天。
  2. 选择类型：聊天选 对话，MidJourney 选 Midjourney，独立 Suno 创作页选 Suno文生歌。
  3. 粘贴上游令牌。
  4. API URL 填 https://api2.geekai.pro。只有上游明确要求时才填写完整接口路径。
  5. 保持启用，点击 提交。
  6. 回到列表确认记录已出现，再到对应功能页完成后续配置。

字段说明

字段说明
名称仅供后台识别，不会发给上游
类型只支持 对话、Midjourney、Suno文生歌
API KEY上游令牌；编辑记录时仍为必填项
API URL上游 Base URL，也兼容供应商要求的完整地址
启用状态关闭后该凭证不会参与调用

一个上游令牌支持多类任务时，需要按类型分别创建记录。

验证方法

  • 对话类型：绑定到一个聊天模型，并在前台发起新对话。
  • MidJourney：打开 /mj 提交任务。
  • Suno 文生歌：打开 /suno 提交任务。
  • 调用失败时同时检查 GeekAI 服务日志和中转站调用日志。

常见错误

  • 401/令牌无效：重新复制令牌，确认没有空格且账户余额可用。
  • 404/接口不存在：优先把 API URL 改回 https://api2.geekai.pro，避免错误拼接路径。
  • 模型不存在：API-KEY 只负责认证；模型名称必须与中转站模型列表完全一致。
  • 前台没有模型：继续完成模型管理，并确保模型已启用。