Xpersona
agentCLAWHUBUnverified

spark-media

使用场景: 用户明确希望通过 AI Skills 平台 API 生成图片、编辑参考图、文生视频、图生视频、制作短视频或查询媒体任务。 Skill: spark-media Owner: youteacher Summary: 使用场景: 用户明确希望通过 AI Skills 平台 API 生成图片、编辑参考图、文生视频、图生视频、制作短视频或查询媒体任务。 Tags: latest:2.5.2 Version history: v2.5.2 | 2026-09-18T09:08:40.827Z | auto - Updated to version 2.5.2. - SKILL.md: Clarified usage scenarios, added license field, and updated packageVersion metadata. - Added completion standards on async operation handling, error retries, and multi-step/multi-file reques

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.1k

Updated

Oct 11, 2026

Version

2.5.2

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 11, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 11, 2026
Adoption signal
1.1K downloadsadoption · observed Oct 11, 2026
Latest release
2.5.2release · observed Sep 18, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17439knp21875y4g295ngvb3s8cwp1y:spark-media
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-youteacher-spark-media/snapshot"

Documentation

CLAWHUB

116,146 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: spark-media
description: "使用场景: 用户明确希望通过 AI Skills 平台 API 生成图片、编辑参考图、文生视频、图生视频、制作短视频或查询媒体任务。"
license: MIT-0
metadata:
    {
        "packageVersion": "2.5.2",
        "openclaw":
            {
                "emoji": "✨",
                "homepage": "https://ai-skills.open-idea.net",
                "primaryEnv": "SPARK_MEDIA_API_KEY",
                "requires": { "env": ["SPARK_MEDIA_API_KEY"] },
            },
    }
---

# Spark 媒体

## Skill 简介

Spark Media 用于根据文字生成图片和视频、基于参考图进行图片或视频创作，并查询媒体任务进度与结果，适合广告图、商品图、海报和短视频素材制作。

## 平台入口与注册

1. 打开 [AI Skills 平台](https://ai-skills.open-idea.net/)，新用户可直接进入 [注册页面](https://ai-skills.open-idea.net/register)，已有账号进入 [登录页面](https://ai-skills.open-idea.net/login)。
2. 登录后进入 [产品管理](https://ai-skills.open-idea.net/dashboard/products) 开通本 Skill，再到 [API 密钥管理](https://ai-skills.open-idea.net/dashboard/keys) 创建密钥。

## Skill 安装与配置

1. 在 [API 密钥管理](https://ai-skills.open-idea.net/dashboard/keys)中选择已开通的产品，创建并复制 API 密钥。
2. 在 OpenClaw 中安装本 Skill。
3. 将复制的密钥配置到本 Skill 的 API 密钥环境变量，然后重启 Gateway：

```sh
openclaw config set env.SPARK_MEDIA_API_KEY "你的平台APIKey"
openclaw gateway restart
```

## 完成标准

- 异步操作提交后持续轮询任务状态，直到成功或失败的终态再汇报；不要在 pending/processing 中途停下征求许可。
- 用户已确认的处理范围内，遇 429/503 按参考文档以原幂等键退避重试（不产生额外扣费），恢复后继续，无需再次确认。
- 一次请求涉及多个文件或多个步骤时，全部处理完再汇报；部分失败要逐项说明哪些成功、哪些失败及原因。

## 参考资料

- [API 密钥配置](https://ai-skills.open-idea.net/skill-docs/spark-media/API-KEY.md)
- [图片生成与编辑](https://ai-skills.open-idea.net/skill-docs/spark-media/IMAGE-GENERATION.md)
- [视频生成与轮询](https://ai-skills.open-idea.net/skill-docs/spark-media/VIDEO-GENERATION.md)
- [HTTP 请求示例](https://ai-skills.open-idea.net/skill-docs/spark-media/HTTP-REQUESTS.md)
- [行为、错误与重试规则](https://ai-skills.open-idea.net/skill-docs/spark-media/BEHAVIOR-RULES.md)

_meta.json

{
  "ownerId": "kn7114n7fws0zkhdbtpvy92sp182gqge",
  "slug": "spark-media",
  "version": "2.5.2",
  "publishedAt": 1789722520827
}

references/API-KEY.md

# API 密钥配置


```bash
export SPARK_MEDIA_API_KEY="ais_..."
export AI_SKILLS_API_URL="https://ai-skills.open-idea.net" # 可选
```

请求根地址为 `${AI_SKILLS_API_URL:-https://ai-skills.open-idea.net}/api/v1`。

```text
Authorization: Bearer $SPARK_MEDIA_API_KEY
```

密钥仅绑定 Spark Media，不能跨 Skill 使用。不要要求用户在聊天中粘贴完整密钥，也不要
将密钥写入代码、提示词、日志或生成文件。常见鉴权错误包括 `invalid_api_key`、
`key_expired`、`key_revoked`、`skill_not_active`、`user_skill_suspended` 和
`account_suspended`。

references/BEHAVIOR-RULES.md

# 行为、错误与重试规则

## 安全与质量

- 不生成违法、有害或侵犯隐私的内容；涉及真人敏感编辑时先核实授权。
- 图像输入只上传完成任务所需内容，敏感图片上传前取得同意。
- 结果字段缺失、解码失败或任务状态未知时明确报告异常，不伪造媒体。
- 保存、移动、重命名或再次展示现有结果时禁止重新生成。

## 幂等与错误

- 四个创建接口都必须有 `Idempotency-Key`；同一请求重试复用原值，参数变化才换新值。
- `validation_failed`（验证失败）：修正尺寸、格式、时长、画幅或字段。
- `insufficient_balance`（余额不足）：提示充值，不自动创建新任务。
- `rate_limited`（受到速率限制）：遵循 `Retry-After` 或有限指数退避。
- `upstream_unavailable`（上游服务不可用）：短暂退避后复用原幂等键重试，限制次数。
- `idempotency_in_progress`（幂等请求处理中）：等待原请求，不换密钥并发提交。
- `idempotency_indeterminate`（幂等结果不确定）：停止自动重试并核对原请求、任务和账单。
- `video_task_in_progress`（视频任务处理中）：查询现有任务，不能绕过单活跃任务限制。

幂等重放返回首次响应与首次计费头。统一计费头为
`X-AI-Skills-Billing-Currency`、`X-AI-Skills-Billing-Charged`、
`X-AI-Skills-Billing-Balance`。

references/HTTP-REQUESTS.md

# HTTP 请求示例

```bash
API_ROOT="${AI_SKILLS_API_URL:-https://ai-skills.open-idea.net}/api/v1"

curl --fail-with-body "$API_ROOT/spark-media/image" \
  -H "Authorization: Bearer $SPARK_MEDIA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: image-uuid-001" \
  -d '{"prompt":"雪山下的藏式村庄，电影感光线","width":1024,"height":1024,"count":1}'
```

```bash
curl --fail-with-body "$API_ROOT/spark-media/video" \
  -H "Authorization: Bearer $SPARK_MEDIA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: video-uuid-001" \
  -d '{"prompt":"云层缓慢掠过雪山","duration":5,"resolution":"720p","ratio":"16:9","watermark":false}'
```

创建返回 HTTP 202 后：

```bash
curl --fail-with-body "$API_ROOT/spark-media/video/TASK_ID" \
  -H "Authorization: Bearer $SPARK_MEDIA_API_KEY"
```

图生图和图生视频将完整的 `data:image/png;base64,...` 放进 JSON 的 `image` 字段；不要
使用 multipart。生产中使用 UUID 等真正唯一的幂等键。

创建响应的计费头是 `X-AI-Skills-Billing-Currency`、
`X-AI-Skills-Billing-Charged`、`X-AI-Skills-Billing-Balance`。

Related agents

Same protocol, similar job.

Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/youteacher/skills/spark-media",
      "sourceUrl": "https://clawhub.ai/youteacher/skills/spark-media",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T05:41:46.134Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-youteacher-spark-media/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-youteacher-spark-media/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-11T05:41:46.134Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.1K downloads",
      "href": "https://clawhub.ai/youteacher/spark-media",
      "sourceUrl": "https://clawhub.ai/youteacher/spark-media",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T05:41:46.134Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "2.5.2",
      "href": "https://clawhub.ai/youteacher/spark-media",
      "sourceUrl": "https://clawhub.ai/youteacher/spark-media",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-09-18T09:08:40.827Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-youteacher-spark-media/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-youteacher-spark-media/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 2.5.2",
      "description": "- Updated to version 2.5.2. - SKILL.md: Clarified usage scenarios, added license field, and updated packageVersion metadata. - Added completion standards on async operation handling, error retries, and multi-step/multi-file request reporting. - Removed skill-card.md.",
      "href": "https://clawhub.ai/youteacher/spark-media",
      "sourceUrl": "https://clawhub.ai/youteacher/spark-media",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-09-18T09:08:40.827Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 11, 2026.

Sponsored

Ads related to spark-media and adjacent AI workflows.