К основному содержанию
скилл CX Codex

generate-image · happycapy-ai — скилл для Claude Code: что делает и как установить

Скилл generate-image для Claude Code генерирует иллюстрации по тексту и редактирует готовые изображения через AI Gateway API. Подключает модели Gemini, Seedream и GPT-Image.

MIT ★ 138 обновлён 2026-09-03

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add happycapy-ai/Happycapy-skills --skill generate-image -a claude-code
Открыть на GitHub

Что делает generate-image

Скилл открывает агенту доступ к шлюзу AI Gateway API для создания и редактирования графики. В состав входят три скрипта Python: generate_image.py для генерации по текстовому описанию, transform_image.py для изменения картинок по ссылке и batch_generate.py для пакетной обработки текстового файла.

Интеграция поддерживает модели Google Vertex AI (gemini-3.1-flash-image-preview, gemini-3-pro-image-preview), Byteplus (seedream-4-5, seedream-4-0) и OpenAI (gpt-image-2, gpt-image-1.5). Для моделей OpenAI можно задавать прозрачный фон через параметр background: "transparent" и выбирать соотношение сторон от 1:1 до 16:9.

Без переменной окружения AI_GATEWAY_API_KEY скрипты сразу завершаются с ошибкой. При написании собственных вызовов на JavaScript авторы требуют передавать заголовок Origin: https://trickle.so для корректной маршрутизации запросов.

Какие задачи решает

  • создать изображение по текстовому описанию через модели Gemini или OpenAI
  • изменить готовую картинку по ссылке с помощью текстовых инструкций
  • запустить пакетную генерацию иллюстраций из текстового файла со списком промптов
  • получить PNG с прозрачным фоном через модели GPT-Image

Примеры запросов агенту

  • Сгенерируй футуристический город в стиле киберпанк через scripts/generate_image.py
  • Измени картинку по ссылке https://example.com/original.jpg, добавив закатное освещение
  • Запусти пакетное создание картинок из файла prompts.txt через batch_generate.py

Как установить generate-image

1Через Skills CLI (Vercel)

npx skills add happycapy-ai/Happycapy-skills --skill generate-image -a claude-code

2Вручную: положить файлы

~/.claude/skills/generate-image/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/generate-image/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о generate-image

Как установить generate-image в Claude Code?

Выполните команду npx skills add happycapy-ai/Happycapy-skills --skill generate-image -a claude-code в терминале.

Что делает generate-image?

Скилл позволяет Claude Code создавать новые изображения и редактировать существующие через API-шлюз AI Gateway. В него встроены готовые скрипты Python для одиночной, ссылочной и пакетной генерации.

Что нужно для работы generate-image?

Обязательно требуется задать переменную окружения AI_GATEWAY_API_KEY с вашим ключом доступа. Без неё вызовы API завершаются с ошибкой.

Исходный текст

SKILL.md · MIT
---
name: generate-image
description: Generate and transform images using AI Gateway API. Use when the user asks to create, generate, produce, or transform images, or work with image generation.
allowed-tools: Bash, Read
---

# Image Generation Skill

Generate images from text prompts and transform existing images using the AI Gateway API with support for multiple AI models including Google Gemini, Byteplus Seedream, and OpenAI GPT-Image.

## Overview

This Skill enables Claude to generate images from text descriptions and transform existing images with AI-powered modifications. It uses the AI Gateway API which routes requests to appropriate providers based on the model selected.

## Prerequisites

**Required Environment Variable:**
- `AI_GATEWAY_API_KEY`: Your AI Gateway API key

If this environment variable is not set, the scripts will fail with an error message asking you to provide it.

## Quick Start

### Generate an Image from Text

Use the bundled script to generate images from text descriptions:

```bash
python3 scripts/generate_image.py "A serene landscape with mountains and a lake at sunset, photorealistic style"
```

### Transform an Existing Image

Apply transformations to existing images using reference URLs:

```bash
python3 scripts/transform_image.py "Make this image more vibrant and add dramatic lighting" "https://example.com/image.jpg"
```

## Supported Models

### Image Generation Models

| Model | Provider | Best For |
|-------|----------|----------|
| `google/gemini-3.1-flash-image-preview` | Google Vertex AI | Latest fast image generation with improved quality |
| `google/gemini-3-pro-image-preview` | Google Vertex AI | High-quality photorealistic images |
| `google/gemini-2.5-flash-image` | Google Vertex AI | Fast image generation |
| `byteplus/seedream-4-5` | Byteplus Seedream | Creative artistic styles |
| `byteplus/seedream-4-0` | Byteplus Seedream | General purpose image generation |
| `openai/gpt-image-1` | OpenAI | Advanced image synthesis |
| `openai/gpt-image-1-mini` | OpenAI | Quick image generation |
| `openai/gpt-image-1.5` | OpenAI | Enhanced image synthesis |
| `openai/gpt-image-2` | OpenAI | Latest generation, multi-aspect ratio support |

## API Parameters

### Image Generation

- `prompt` (required): Text description of the desired image
- `model` (required): Model to use for generation
- `images` (optional): Array of reference image URLs for image-to-image transformation
- `response_format` (optional): "url" (default) or "b64_json"
- `n` (optional): Number of images to generate (default: 1)
- `size` (optional): Image dimensions (e.g., "1024x1024", "1792x1024", "1024x1792", "1536x1024", "1024x1536")
- `aspectRatio` (optional): Aspect ratio — alternative to `size`. Supported values: `"1:1"`, `"16:9"`, `"9:16"`, `"3:2"`, `"2:3"`, `"4:3"`, `"3:4"`, `"3:1"`, `"1:3"`
- `background` (optional, OpenAI models only): `"transparent"` | `"opaque"` | `"auto"` — controls background transparency
- `user` (optional): User identifier for tracking

### OpenAI gpt-image-2 / gpt-image-1.5 Parameters

These models support the full parameter set above. Key notes:
- Supports all aspect ratios via `aspectRatio` field
- Supports `background: "transparent"` for PNG output with transparency
- Use `response_format: "b64_json"` to receive raw image data; use `"url"` for a hosted URL
- Image editing (passing `images`) routes to the `/images/edits` endpoint automatically

## Bundled Scripts

### 1. generate_image.py

Generate images from text prompts with customizable parameters.

**Usage:**
```bash
python3 scripts/generate_image.py "prompt" [--model MODEL] [--output OUTPUT] [--format FORMAT]
```

**Options:**
- `--model`: Model to use (default: google/gemini-3.1-flash-image-preview)
- `--output`: Output file path (default: generated_image.png)
- `--format`: Response format - "url" or "b64_json" (default: b64_json)

**Example:**
```bash
python3 scripts/generate_image.py \
  "A futuristic city with flying cars at night, cyberpunk style" \
  --model "google/gemini-3.1-flash-image-preview" \
  --output "city.png"
```

### 2. transform_image.py

Transform existing images using AI with text instructions.

**Usage:**
```bash
python3 scripts/transform_image.py "prompt" "image_url" [--model MODEL] [--output OUTPUT]
```

**Example:**
```bash
python3 scripts/transform_image.py \
  "Make this image more vibrant and add dramatic sunset lighting" \
  "https://example.com/original.jpg" \
  --output "enhanced.png"
```

### 3. batch_generate.py

Generate multiple images in batch.

**Usage:**
```bash
python3 scripts/batch_generate.py prompts.txt [--model MODEL]
```

**Example prompts.txt:**
```
A sunset over the ocean
A mountain landscape at dawn
A bustling city street at night
```

## Implementation Notes

**When implementing image generation tasks:**

1. **Always use JavaScript for API calls** when writing custom code
2. **Check for API Key** at the start:
   ```javascript
   const apiKey = process.env.AI_GATEWAY_API_KEY;
   if (!apiKey) {
     throw new Error('AI_GATEWAY_API_KEY environment variable is required. Please set it with your AI Gateway API key.');
   }
   ```

3. **Use the bundled Python scripts** for quick generation tasks rather than writing custom code

4. **Include Origin header** in all API requests: Set `Origin: https://trickle.so` header for proper request routing

5. **Handle both streaming and non-streaming responses** appropriately

6. **Save generated images** to appropriate file paths and inform the user

## JavaScript Implementation Template

When you need to write custom JavaScript code for image generation:

```javascript
const apiKey = process.env.AI_GATEWAY_API_KEY;
if (!apiKey) {
  throw new Error('AI_GATEWAY_API_KEY environment variable is required. Please set it with your AI Gateway API key.');
}

const API_BASE = `${process.env.AI_GATEWAY_BASE_URL}/api/v1`;

async function generateImage(prompt, model = 'google/gemini-3.1-flash-image-preview') {
  const response = await fetch(`${API_BASE}/images/generations`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${apiKey}`,
      'Origin': 'https://trickle.so'
    },
    body: JSON.stringify({
      model,
      prompt,
      response_format: 'url'
    })
  });

  if (!response.ok) {
    throw new Error(`API request failed: ${response.status} ${response.statusText}`);
  }

  return await response.json();
}

// Use the function
const result = await generateImage('A beautiful sunset over mountains');
console.log('Generated image URL:', result.data[0].url);
```

## Error Handling

All scripts include comprehensive error handling for:
- Missing API key
- Network failures
- Invalid responses
- File I/O errors

Errors will include helpful messages to guide troubleshooting.

## Best Practices

1. **Be Specific in Prompts**: Include style, mood, lighting, and composition details
2. **Use Appropriate Models**: Choose models based on your quality vs. speed requirements
3. **Reference Images**: Use image-to-image transformation for style transfer or modifications
4. **Batch Processing**: Use the batch script for multiple generations to save time
5. **Save Outputs**: Always specify meaningful output file names for organization

## Troubleshooting

### "AI_GATEWAY_API_KEY environment variable is required"
Set the environment variable before running scripts:
```bash
export AI_GATEWAY_API_KEY="your-api-key-here"
```

### Network Errors
Check your internet connection and verify the API Gateway is accessible.

### Invalid Model Errors
Ensure you're using a valid model name from the supported models list above.

## Additional Resources

For more details on API parameters and response formats, see the API documentation at the AI Gateway repository.

© happycapy-ai · MIT · happycapy-ai/Happycapy-skills

Похожие скиллы

Все скиллы по теме «ИИ и ML» →

Сначала — generate-image от других авторов.

generate-image K-Dense-AI Скилл generate-image для Claude Code генерирует и редактирует изображения через OpenRouter Image API в моделях Gemini, Recraft и Seedream. Создаёт иллюстрации, логотипы и концепт-арт. CX Codex +1 2 200установок generate-image официальный github Скилл generate-image для GitHub Copilot создаёт изображения по запросу через OpenAI или Google Gemini. Создаёт текстуры, иконки, спрайты и макеты прямо в проекте. CX Codex +1 93установок generate-image OpenClaudia Скилл generate-image для Claude Code генерирует изображения по текстовому описанию через OpenAI или Stability AI. Готовит баннеры, иконки и иллюстрации для проекта. CX Codex +1 360установок generate-image laurigates Скилл generate-image генерирует изображения из текстового описания через модель Gemini 3 Pro Image, работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 177установок generate-image Sateezg Скилл generate-image рисует иконки, логотипы, баннеры и иллюстрации через gpt-image-2 в локальном Codex CLI, используя ваш вход в ChatGPT. Ключ API не нужен. CX Codex +1 ★ 195звёзд репо image-gen Nick Nisi Скилл image-gen для Claude Code создаёт и редактирует изображения через Gemini или OpenAI. Создаёт иллюстрации, диаграммы и изображения с читаемыми подписями. CX Codex +1 ★ 114звёзд репо skill-image-gen официальный adamd9 Плагин skill-image-gen для GitHub Copilot генерирует изображения по текстовому описанию прямо в редакторе. Создаёт иконки, текстуры и спрайты без перехода в сторонние сервисы. ★ 41 430звёзд репо mcp-image shinpr MCP-сервер mcp-image создаёт и редактирует изображения через Gemini, OpenAI или BytePlus Seedream, уточняя короткий запрос перед генерацией. CX Codex +1 ★ 195звёзд репо Image Gen nuver-labs MCP-сервер Image Gen для Claude Code и Codex: генерирует и редактирует иллюстрации в проекте через Gemini и OpenAI. Создаёт плейсхолдеры, обложки, правит логотипы. CX Codex +1 ★ 1звёзд репо image-generation zc277584121 Скилл image-generation создаёт иллюстрации, схемы и визуалы для статей и документации. Подбирает путь через Codex, OpenAI API или Gemini. CX Codex +1 4 000установок gpt-image-2 prime-skills Генерирует и редактирует изображения через OpenAI GPT Image 2 на RunComfy. Точно встраивает текст, логотипы и многоязычную типографику — для e-commerce, рекламы и UI-макетов. CX Codex +1 95 100установок

Из того же набора41

Весь набор →
agent-1-issue-scout Субагент agent-1-issue-scout для Claude, который ищет в отобранных GitHub-репозиториях свободные «good first issue» и отдаёт одну выбранную задачу следующему агенту цепочки. CX Codex ★ 138звёзд репо html-over-markdown Скилл html-over-markdown создаёт автономные HTML-файлы с диаграммами, сетками и интерактивом вместо Markdown для отчётов, планов и разборов кода. CX Codex +1 ★ 138звёзд репо contract-first-agents Скилл contract-first-agents для Claude Code задаёт общий контракт перед запуском параллельных агентов, затем проверяет результат и предлагает исправить ошибки. Используется в задачах, части которых должны состыковаться. CX Codex +1 ★ 138звёзд репо agent-9-status-monitor Субагент agent-9-status-monitor для Claude, который следит за открытыми пул-реквестами: ловит мержи, закрытия, новые ревью и падения CI, обновляет историю и шлёт алерты соседним агентам роя. CX Codex ★ 138звёзд репо agent-0-strategic-planner Субагент agent-0-strategic-planner оценивает GitHub-задачи и выбирает те, что обещают пользу пользователям. Он пригодится для планирования осмысленных вкладов в проекты с открытым исходным кодом. CX Codex ★ 138звёзд репо claude-code-templates Скилл ставит и настраивает CLI claude-code-templates: каталог агентов, слэш-команд, MCP-серверов, хуков и шаблонов проектов для Claude, плюс мониторинг сессий. CX Codex +1 ★ 138звёзд репо 360-panorama-viewer Скилл 360-panorama-viewer собирает автономный HTML-файл с 360° панорамами на Three.js без внешнего сервера. Подходит для интерактивных VR-галерей из готовых или сгенерированных эквидистантных картинок. CX Codex +1 ★ 138звёзд репо agent-8-review-responder Субагент agent-8-review-responder отслеживает отзывы и проверки CI в PR, отвечает на вопросы и исправляет простые замечания. Сложные изменения и проблемы безопасности он передаёт человеку. CX Codex ★ 138звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой