Coze Image Skill

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:

Parameters

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

1. Install the skill via ClawHub:

   openclaw skills install coze-image
   

2. Configure your API token:

   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

License

MIT License - See license file for details.

Support

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