返回顶部
j

jiekou-multimodal接口多模态

|

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 0.2.0
安全检测
已通过
305
下载量
免费
免费
1
收藏
概述
安装方式
版本历史

jiekou-multimodal

接口AI 多模态执行

配置方式(三选一,按优先级)

方式1:配置文件(推荐)

创建文件 ~/.jiekou/config.json:

json
{
apikey: 你的APIKey
}

一条命令完成配置:
bash
mkdir -p ~/.jiekou && echo {apikey: 你的APIKey} > ~/.jiekou/config.json

方式2:环境变量

bash
export JIEKOUAPIKEY=你的API_Key

方式3:直接传参

在请求中直接提供:请用 API Key sk_xxx 生成一张图片...



API Key 读取逻辑

  1. 1. 检查用户消息中是否包含 API Key(sk 开头)
  2. 检查配置文件 ~/.jiekou/config.json
  3. 检查环境变量 JIEKOUAPI_KEY
  4. 都没有 → 返回配置引导

配置引导消息(仅在未配置时显示):

您还没有配置接口AI的 API Key。

快速配置(复制运行):
mkdir -p ~/.jiekou && echo {api_key: 你的Key} > ~/.jiekou/config.json

获取 Key:https://jiekou.ai/settings/key-management



执行流程(重要!)

用户请求 → 识别任务 → 获取 Key → ⚠️ 先发提示 → 执行任务 → 返回结果

⚠️ 必须先发送进度提示

在调用 API 之前,必须先回复用户一条消息:

🎨 收到!正在为您生成图片...

任务类型:文生图
使用模型:Gemini 3.1 Flash Image
预计耗时:10-30秒
预计费用:约 $0.03 元

请稍等,生成完成后会立即发送给您 ⏳

这条消息必须在执行 API 调用之前发送! 这样用户就知道任务已经开始处理,不会以为系统卡住了。

不同任务的提示模板

文生图:

🎨 收到!正在为您生成图片...
使用模型:Gemini 3.1 Flash Image
预计耗时:10-30秒

文生视频:

🎬 收到!正在为您生成视频...
使用模型:Veo 3.1
预计耗时:1-3分钟(视频生成较慢,请耐心等待)

TTS:

🔊 收到!正在为您生成语音...
使用模型:MiniMax Speech 2.6
预计耗时:5-10秒

完成后的回复

✅ 生成完成!

[图片/视频/音频 URL]

实际消耗:$0.03 元

视频任务的轮询提示

视频生成需要轮询,每 15 秒更新一次状态:

🎬 视频生成中...
当前状态:处理中
已等待:30 秒
预计还需:1-2 分钟



API 配置


配置项
Base URLhttps://api.jiekou.ai
鉴权
Authorization: Bearer |
| 获取 Key | https://jiekou.ai/settings/key-management |

任务类型与端点

任务端点默认模型快速模型
文生图/v3/gemini-3.1-flash-image-text-to-imageGemini 3.1 FlashSeedream 5.0 Lite
图片编辑
/v3/gemini-3.1-flash-image-edit | Gemini 3.1 Flash | - | | 文生视频 | /v3/async/veo-3.1-generate-text2video | Veo 3.1 | Hailuo 2.3 | | 图生视频 | /v3/async/veo-3.1-generate-img2video | Veo 3.1 | Hailuo 2.3 | | TTS | /v3/minimax-speech-2.6-turbo | MiniMax Speech 2.6 | - | | 任务查询 | /v3/async/task-result?task_id=xxx | - | - |

快速模型触发词: 用户说快点、加速、着急时使用快速模型



执行模板

文生图

bash
curl -X POST https://api.jiekou.ai/v3/gemini-3.1-flash-image-text-to-image \
-H Authorization: Bearer $API_KEY \
-H Content-Type: application/json \
-d {prompt: 描述, size: 1K, aspect_ratio: 1:1}

快速模式:
bash
curl -X POST https://api.jiekou.ai/v3/seedream-5.0-lite \
-H Authorization: Bearer $API_KEY \
-H Content-Type: application/json \
-d {prompt: 描述}

图片编辑

bash
curl -X POST https://api.jiekou.ai/v3/gemini-3.1-flash-image-edit \
-H Authorization: Bearer $API_KEY \
-H Content-Type: application/json \
-d {prompt: 编辑指令, reference_images: [图片URL]}

文生视频

bash
curl -X POST https://api.jiekou.ai/v3/async/veo-3.1-generate-text2video \
-H Authorization: Bearer $API_KEY \
-H Content-Type: application/json \
-d {prompt: 描述, duration_seconds: 4}

快速模式:
bash
curl -X POST https://api.jiekou.ai/v3/async/minimax-hailuo-2.3-t2v \
-H Authorization: Bearer $API_KEY \
-H Content-Type: application/json \
-d {prompt: 描述, duration: 6}

图生视频

bash
curl -X POST https://api.jiekou.ai/v3/async/veo-3.1-generate-img2video \
-H Authorization: Bearer $API_KEY \
-H Content-Type: application/json \
-d {prompt: 动作描述, image: 图片URL}

TTS

bash
curl -X POST https://api.jiekou.ai/v3/minimax-speech-2.6-turbo \
-H Authorization: Bearer $API_KEY \
-H Content-Type: application/json \
-d {
text: 要转换的文字,
voicesetting: {voiceid: male-qn-qingse, speed: 1.0},
audio_setting: {format: mp3}
}

可用声音:

  • - 男声:male-qn-qingse(青涩)、male-qn-jingying(精英)
  • 女声:female-shaonv(少女)、female-yujie(御姐)

任务结果查询

bash
curl https://api.jiekou.ai/v3/async/task-result?taskid=$TASKID \
-H Authorization: Bearer $API_KEY

状态: TASKSTATUSQUEUED → TASKSTATUSPROCESSING → TASKSTATUSSUCCEED



错误处理


错误码含义处理
401Key 无效检查配置
402
余额不足 | https://jiekou.ai/billing 充值 |
| 429 | 请求过快 | 等待重试 |

定价

https://jiekou.ai/pricing

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 jiekou-multimodal-1776117131 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 jiekou-multimodal-1776117131 技能

通过命令行安装

skillhub install jiekou-multimodal-1776117131

下载

⬇ 下载 jiekou-multimodal v0.2.0(免费)

文件大小: 10.23 KB | 发布时间: 2026-4-15 13:08

v0.2.0 最新 2026-4-15 13:08
**简要版本更新内容:本版本优化了 API Key 配置流程,增强了用户体验提示,简化了文档结构。**

- 支持三种 API Key 配置方式:配置文件(推荐)、环境变量、或直接传参,优先级明确。
- 增加详细的进度提示规范,执行前先向用户说明处理进度和预计耗时。
- 优化了视频生成的轮询状态提示,每 15 秒自动更新进度。
- 删除了部分原有功能说明(如图片/音频/视频理解),聚焦“文生图、图生图、文生视频、图生视频、TTS、STT”六大任务类型。
- 简化并梳理 API 端点与调用示例,明确“快速模型”触发词和场景。
- 更新了错误处理与费用说明。

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部