zhipu-image

TotalClaw 作者 totalclaw

使用Zhipu AI的CogView模型生成图像

安装 / 下载方式

TotalClaw CLI推荐

totalclaw skills install shop:totalclaw:totalclaw~honestqiao-zhipu-cogview-image

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~honestqiao-zhipu-cogview-image/file -o honestqiao-zhipu-cogview-image.md

# Zhipu Image Generation

Generate images using Zhipu AI's CogView model.

## ⚠️ Security Requirements

**This skill requires `ZHIPU_API_KEY` environment variable to be set before use.**

### Security Best Practices:

1. **DO NOT store API keys in ~/.bashrc** - keys can be leaked
2. **DO NOT source shell configuration files** - prevents arbitrary code execution
3. **Set environment variable directly** when running the script

## Setup

```bash
export ZHIPU_API_KEY="your_api_key"
```

**Get your API key from:** https://www.bigmodel.cn/usercenter/proj-mgmt/apikeys

## Usage

### Quick Example

```bash
export ZHIPU_API_KEY="your_key"

curl -s -X POST "https://open.bigmodel.cn/api/paas/v4/images/generations" \
  -H "Authorization: Bearer $ZHIPU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "cogview-4", "prompt": "your description"}'
```

### Using the Script

```bash
export ZHIPU_API_KEY="your_key"
./generate.sh "A beautiful Chinese girl in white dress"
```

## Security Analysis

### ✅ What's Safe:
- No sourcing of ~/.bashrc or shell config files
- Uses jq for JSON escaping (prevents injection)
- Uses HTTPS with TLS 1.2+
- API key via environment variable (not hardcoded)
- Input validation (prompt length limit)
- Generic error messages

### ⚠️ Considerations:
- **Process list visibility**: API key visible in `ps aux`
- Use in trusted environments only

## Safety Features

| Feature | Implementation |
|---------|----------------|
| JSON escaping | jq prevents injection |
| Input validation | Prompt length ≤1000 chars |
| TLS | Force TLS 1.2+ |
| Timeout | 60 second curl timeout |
| Error handling | Generic messages only |

## Model

Uses **CogView-4** model from Zhipu AI.

## API Endpoint

**Official:** `https://open.bigmodel.cn/api/paas/v4/images/generations`

---

## 中文说明

# Zhipu 图像生成（Zhipu Image Generation）

使用 Zhipu AI 的 CogView 模型生成图像。

## ⚠️ 安全要求

**本技能在使用前需要设置 `ZHIPU_API_KEY` 环境变量。**

### 安全最佳实践：

1. **不要将 API 密钥存储在 ~/.bashrc 中** - 密钥可能泄露
2. **不要 source shell 配置文件** - 以防止任意代码执行
3. 运行脚本时**直接设置环境变量**

## 设置

```bash
export ZHIPU_API_KEY="your_api_key"
```

**从此处获取你的 API 密钥：** https://www.bigmodel.cn/usercenter/proj-mgmt/apikeys

## 用法

### 快速示例

```bash
export ZHIPU_API_KEY="your_key"

curl -s -X POST "https://open.bigmodel.cn/api/paas/v4/images/generations" \
  -H "Authorization: Bearer $ZHIPU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "cogview-4", "prompt": "your description"}'
```

### 使用脚本

```bash
export ZHIPU_API_KEY="your_key"
./generate.sh "A beautiful Chinese girl in white dress"
```

## 安全分析

### ✅ 安全之处：
- 不 source ~/.bashrc 或 shell 配置文件
- 使用 jq 进行 JSON 转义（防止注入）
- 使用 HTTPS 并启用 TLS 1.2+
- 通过环境变量传递 API 密钥（非硬编码）
- 输入验证（提示词长度限制）
- 通用错误消息

### ⚠️ 注意事项：
- **进程列表可见性**：API 密钥在 `ps aux` 中可见
- 仅在受信任的环境中使用

## 安全特性

| 特性 | 实现方式 |
|---------|----------------|
| JSON 转义 | jq 防止注入 |
| 输入验证 | 提示词长度 ≤1000 字符 |
| TLS | 强制 TLS 1.2+ |
| 超时 | 60 秒 curl 超时 |
| 错误处理 | 仅通用消息 |

## 模型

使用 Zhipu AI 的 **CogView-4** 模型。

## API 端点

**官方：** `https://open.bigmodel.cn/api/paas/v4/images/generations`