Skill: ximasadila/jiekou-multimodal (version 0.2.0)

--- name: jiekou-multimodal description: | 使用接口AI 执行多模态任务：文生图、图生图、文生视频、图生视频、TTS、STT。 适用于：生成图片、生成视频、文字转语音、语音识别。 --- # 接口AI 多模态执行 ## 配置方式（三选一，按优先级） ### 方式1：配置文件（推荐） 创建文件 `~/.jiekou/config.json`： ```json { "api_key": "你的API_Key" } ``` **一条命令完成配置：** ```bash mkdir -p ~/.jiekou && echo '{"api_key": "你的API_Key"}' > ~/.jiekou/config.json ``` ### 方式2：环境变量 ```bash export JIEKOU_API_KEY="你的API_Key" ``` ### 方式3：直接传参 在请求中直接提供：`请用 API Key sk_xxx 生成一张图片...` --- ## API Key 读取逻辑 ``` 1. 检查用户消息中是否包含 API Key（sk_ 开头） 2. 检查配置文件 ~/.jiekou/config.json 3. 检查环境变量 JIEKOU_API_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 URL | `https://api.jiekou.ai` | | 鉴权 | `Authorization: Bearer <API_KEY>` | | 获取 Key | https://jiekou.ai/settings/key-management | ## 任务类型与端点 | 任务 | 端点 | 默认模型 | 快速模型 | |------|------|----------|----------| | 文生图 | `/v3/gemini-3.1-flash-image-text-to-image` | Gemini 3.1 Flash | Seedream 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": "要转换的文字", "voice_setting": {"voice_id": "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?task_id=$TASK_ID" \ -H "Authorization: Bearer $API_KEY" ``` **状态：** `TASK_STATUS_QUEUED` → `TASK_STATUS_PROCESSING` → `TASK_STATUS_SUCCEED` --- ## 错误处理 | 错误码 | 含义 | 处理 | |--------|------|------| | 401 | Key 无效 | 检查配置 | | 402 | 余额不足 | https://jiekou.ai/billing 充值 | | 429 | 请求过快 | 等待重试 | ## 定价 https://jiekou.ai/pricing


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)