How do I install the Coze Image skill?

Run npx skillmds@latest add lord1egypt/coze-image in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Coze Image safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Coze Image?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Coze Image free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Coze Image?

Lord1Egypt (@lord1egypt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Coze Image by lord1egypt — Agent Skill

Name: Coze Image
Rating: 4.666666666666667 (3 reviews)
Author: Lord1Egypt

File contents

Coze Image Generation Skill

Generate images from text prompts using the Coze AI platform. This skill handles the complete workflow: submitting prompts, parsing SSE responses, downloading images, and returning Base64-encoded data URIs for inline display.

Usage

Basic Usage

from coze_image_skill import run

result = run({
    "text": "一只可爱的小猫，毛茸茸的，大眼睛，坐在窗台上",
    "api_token": "your_coze_api_token"
})

# Result contains:
# - image: data:image/jpeg;base64,... (inline Base64)
# - mime_type: image/jpeg
# - filename: generated-image.jpeg
# - source_url: original image URL

With Custom Configuration

result = run({
    "prompt": "a cute orange cat playing on grass, sunny day",
    "api_token": "your_token",
    "project_id": "your_project_id",
    "session_id": "your_session_id",
    "timeout": 90,
    "include_debug": True
})

Environment Variables

Set these in your OpenClaw configuration or .env file:

Variable	Description	Default
`IMAGE_API_TOKEN`	Coze API authentication token	Required
`IMAGE_API_URL`	Coze stream_run endpoint	`https://6fj9k4p9x3.coze.site/stream_run`
`IMAGE_API_PROJECT_ID`	Coze project ID	`7621854258107039796`
`IMAGE_API_SESSION_ID`	Coze session ID	`mT8SQeCGgTMZNBsJEiRuN`
`IMAGE_API_TIMEOUT`	Request timeout in seconds	`60`

Parameters

Parameter	Type	Description
`text` or `prompt`	string	Image generation prompt (required)
`api_token`	string	Coze API token (or use env var)
`project_id`	string	Coze project ID (or use env var)
`session_id`	string	Coze session ID (or use env var)
`timeout`	int	Request timeout in seconds
`include_debug`	bool	Include debug info in response
`strict`	bool	Raise exceptions instead of returning error object

Response Format

Success

{
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
  "mime_type": "image/jpeg",
  "filename": "generated-image.jpeg",
  "source_url": "https://..."
}

Error

{
  "error": "Error message describing what went wrong",
  "image": null,
  "mime_type": null,
  "filename": null,
  "source_url": null
}

Features

SSE Streaming: Handles Coze's Server-Sent Events response format
Auto Download: Automatically downloads generated images and converts to Base64
Error Handling: Graceful error handling with structured error responses
Flexible Auth: Supports both inline token and environment variables
Debug Mode: Optional debug output for troubleshooting

Setup on ClawHub

Install the skill via ClawHub:
```
openclaw skills install coze-image
```

Configure your API token:

openclaw config set IMAGE_API_TOKEN your_token_here

Generate your first image:

Generate a picture of a sunset over the ocean

Troubleshooting

"Image URL not found in SSE response"

This means the Coze project returned text instead of an image. Make sure:

Your Coze bot has an image generation plugin enabled
The workflow is configured to return images
The prompt is appropriate for image generation

Authentication Errors

Verify your API token is valid and not expired
Check that the token has permission to access the project
Ensure environment variables are set correctly

Timeout Errors

Increase the timeout parameter (default 60s)
Check your network connection
The image generation may be taking longer than expected

License

MIT License - See license file for details.

Support

For issues or questions, please open an issue on the ClawHub repository.

---name: coze-imagedescription: Generate images using Coze AI platform. Supports text-to-image generation with automatic Base64 encoding for inline preview. Use when you need to create images from text prompts.---# Coze Image Generation SkillGenerate images from text prompts using the Coze AI platform. This skill handles the complete workflow: submitting prompts, parsing SSE responses, downloading images, and returning Base64-encoded data URIs for inline display.## Usage### Basic Usage```pythonfrom coze_image_skill import runresult = run({ "text": "一只可爱的小猫，毛茸茸的，大眼睛，坐在窗台上", "api_token": "your_coze_api_token"})# Result contains:# - image: data:image/jpeg;base64,... (inline Base64)# - mime_type: image/jpeg# - filename: generated-image.jpeg# - source_url: original image URL```### With Custom Configuration```pythonresult = run({ "prompt": "a cute orange cat playing on grass, sunny day", "api_token": "your_token", "project_id": "your_project_id", "session_id": "your_session_id", "timeout": 90, "include_debug": True})```## Environment VariablesSet these in your OpenClaw configuration or `.env` file:| Variable | Description | Default ||----------|-------------|---------|| `IMAGE_API_TOKEN` | Coze API authentication token | Required || `IMAGE_API_URL` | Coze stream_run endpoint | `https://6fj9k4p9x3.coze.site/stream_run` || `IMAGE_API_PROJECT_ID` | Coze project ID | `7621854258107039796` || `IMAGE_API_SESSION_ID` | Coze session ID | `mT8SQeCGgTMZNBsJEiRuN` || `IMAGE_API_TIMEOUT` | Request timeout in seconds | `60` |## Parameters| Parameter | Type | Description ||-----------|------|-------------|| `text` or `prompt` | string | Image generation prompt (required) || `api_token` | string | Coze API token (or use env var) || `project_id` | string | Coze project ID (or use env var) || `session_id` | string | Coze session ID (or use env var) || `timeout` | int | Request timeout in seconds || `include_debug` | bool | Include debug info in response || `strict` | bool | Raise exceptions instead of returning error object |## Response Format### Success```json{ "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg...", "mime_type": "image/jpeg", "filename": "generated-image.jpeg", "source_url": "https://..."}```### Error```json{ "error": "Error message describing what went wrong", "image": null, "mime_type": null, "filename": null, "source_url": null}```## Features- **SSE Streaming**: Handles Coze's Server-Sent Events response format- **Auto Download**: Automatically downloads generated images and converts to Base64- **Error Handling**: Graceful error handling with structured error responses- **Flexible Auth**: Supports both inline token and environment variables- **Debug Mode**: Optional debug output for troubleshooting## Setup on ClawHub1. Install the skill via ClawHub: ```bash openclaw skills install coze-image ```2. Configure your API token: ```bash openclaw config set IMAGE_API_TOKEN your_token_here ```3. Generate your first image: ``` Generate a picture of a sunset over the ocean ```## Troubleshooting### "Image URL not found in SSE response"This means the Coze project returned text instead of an image. Make sure:- Your Coze bot has an image generation plugin enabled- The workflow is configured to return images- The prompt is appropriate for image generation### Authentication Errors- Verify your API token is valid and not expired- Check that the token has permission to access the project- Ensure environment variables are set correctly### Timeout Errors- Increase the timeout parameter (default 60s)- Check your network connection- The image generation may be taking longer than expected## LicenseMIT License - See license file for details.## SupportFor issues or questions, please open an issue on the ClawHub repository.

Frequently asked questions

Coze Image