# Jiekou Multimodal

> 使用接口AI 执行多模态任务：文生图、图生图、文生视频、图生视频、TTS、STT。 适用于：生成图片、生成视频、文字转语音、语音识别。

- Skill: `jiekouai/jiekou-multimodal` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add jiekouai/jiekou-multimodal`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jiekouai/jiekou-multimodal/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jiekouai (https://skillmd.com/u/jiekouai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jiekouai/jiekou-multimodal

---


# 接口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