jimeng-api-image-gen
(project - Skill) Generate AI images using Volcengine Jimeng API 4.0. Use when users request image generation from text prompts, image-to-image editing, or batch image creation. Triggers include "generate image", "create picture", "AI image", "Jimeng", "Seedream", or any request involving AI-powered image creation from descriptions.
- Installs
- 501
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/wvlvik/toy-skills --skill jimeng-api-image-gen- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads jimeng-api-image-gen automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Jimeng API Image Generation
Generate high-quality AI images using Volcengine's Jimeng 4.0 API with text prompts or image inputs.
Configure Environment Variables
# ~/.zshrc or ~/.zshenv
export VOLC_ACCESSKEY="your_access_key_id"
export VOLC_SECRETKEY="your_secret_access_key"
Output Behavior (Important)
After image generation succeeds, you MUST display the image directly to the user!
When generation completes, output in the following format:
**Generation Info:**
- Prompt: [User's original prompt]
- Size: [Image dimensions]
- Save Path: [Local file path, if applicable]
Example Output
**Generation Info:**
- Prompt: Shiba Inu under cherry blossom tree, warm sunlight, healing art style
- Size: 2304 × 1728
- Save Path: /generated_images/[Generated Image] **important**
Notes
- Prefer markdown image syntax
to display images directly - Also provide the online link for easy copying and sharing
- If saved locally, display the local file path
- For multiple images, display each one with numbered labels
Quick Start
Step 1: Run Generation
# Text-to-image
scripts/generate_image.py "A white Siamese cat sitting on a windowsill, sunlight streaming in"
# With specific size
scripts/generate_image.py "Mountain sunset landscape" --size 2K
# Image-to-image editing
scripts/generate_image.py "Change to watercolor style" --images https://example.com/input.jpg
# Save to file
scripts/generate_image.py "Serene lake at sunset" --output /generated_images/lake.png
API Configuration
| Parameter | Value | Description |
|---|---|---|
| Endpoint | https://visual.volcengineapi.com | API base URL |
| Submit Action | CVSync2AsyncSubmitTask | Submit async generation task |
| Query Action | CVSync2AsyncGetResult | Query task result |
| Version | 2022-08-31 | API version |
| Service | cv | Service name for signing |
| Region | cn-north-1 | Region for signing |
| req_key | jimeng_t2i_v40 | Jimeng AI 4.0 model identifier |
Image Size Options
Preset Resolutions
| Preset | Resolution | Pixels |
|---|---|---|
| 1K | 1024×1024 | 1,048,576 |
| 2K | 2048×2048 | 4,194,304 (default) |
| 4K | 4096×4096 | 16,777,216 |
Exact Dimensions
Use --width and --height together:
scripts/generate_image.py "prompt" --width 2560 --height 1440
Recommended aspect ratios:
- 1:1 (2048x2048) - Social media posts
- 4:3 (2304x1728) - Presentations
- 16:9 (2560x1440) - Widescreen displays
- 9:16 (1440x2560) - Mobile vertical
- 3:2 (2496x1664) - Photography
Constraints:
- Width × Height must be in [1024×1024, 4096×4096]
- Aspect ratio (width/height) in [1/16, 16]
- Recommended: Use 2K+ for better quality
Command-Line Options
scripts/generate_image.py PROMPT [OPTIONS]
Arguments:
PROMPT Text prompt for image generation (required, max 800 chars)
Options:
--size SIZE Image size: 1K, 2K, 4K or WxH (default: 2K)
--width WIDTH Exact width (requires --height)
--height HEIGHT Exact height (requires --width)
--images URL [...] Input image URLs for image-to-image (max 10)
--watermark Add "AI Generated" watermark
--scale FLOAT Text influence 0-1 (default: 0.5)
--force-single Force single image output
--output PATH Download image to file
--json Output raw JSON response
Environment Variables:
VOLC_ACCESSKEY Access Key ID (required)
VOLC_SECRETKEY Secret Access Key (required)
JIMENG_API_URL API endpoint (default: https://visual.volcengineapi.com)
JIMENG_API_TIMEOUT Request timeout seconds (default: 120)
JIMENG_POLL_INTERVAL Polling interval seconds (default: 2)
JIMENG_MAX_POLL_ATTEMPTS Max polling attempts (default: 60)
Authentication
This skill uses Volcengine IAM v4 signature authentication (HMAC-SHA256). The signing process:
- Build canonical request with headers:
content-type;host;x-content-sha256;x-date - Calculate SHA256 hash of canonical request
- Derive signing key: secret_key → date → region → service → "request"
- Sign the string-to-sign with derived key
- Add
Authorizationheader to request
Reference: HTTP请求示例
Error Codes
| Code | Message | Description |
|---|---|---|
| 10000 | Success | Request successful |
| 50411 | Pre Img Risk Not Pass | Input image failed content check |
| 50511 | Post Img Risk Not Pass | Output image failed content check |
| 50412 | Text Risk Not Pass | Input text failed content check |
| 50413 | Post Text Risk Not Pass | Input text contains sensitive words |
| 50429 | Request Has Reached API Limit | Rate limit exceeded, retry later |
| 50500 | Internal Error | Server error |
| timeout | Request timeout | Increase JIMENG_API_TIMEOUT |
Input/Output Limits
Input Images:
- Format: JPEG, PNG only
- Max files: 10 images
- Max size: 15MB per image
- Max resolution: 4096×4096
- Aspect ratio (W/H): [1/3, 3]
Output:
- Max images: 15 - (input image count)
- Format: PNG
- URL validity: 24 hours
Reference Documentation
FAQ
What does the jimeng-api-image-gen skill do?
(project - Skill) Generate AI images using Volcengine Jimeng API 4.0. Use when users request image generation from text prompts, image-to-image editing, or batch image creation. Triggers include "generate image", "create picture", "AI image", "Jimeng", "Seedream", or any request involving AI-powered image creation from descriptions.
How do I install jimeng-api-image-gen?
Run npx skills add https://github.com/wvlvik/toy-skills --skill jimeng-api-image-gen in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/jimeng-api-image-gen/ (personal) or .claude/skills/jimeng-api-image-gen/ (project).
Which AI agents can use jimeng-api-image-gen?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is jimeng-api-image-gen safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains jimeng-api-image-gen?
It is published by wvlvik in wvlvik/toy-skills. It has 501 recorded installs.
More from wvlvik/toy-skills
jimeng-api-video-gen
wvlvik/toy-skills
(project - Skill) Generate AI videos using Volcengine Jimeng Video 3.0 Pro API. Use when users request video generation from text prompts or images, including text-to-video, image-to-video, or any AI-powered video creation. Triggers include "generate video", "create video", "AI video", "Jimeng video", "text to video", "image to video", or any request involving AI-powered video generation from descriptions.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image