X2C 发布 - 分发与钱包 API

将视频内容发布到 X2C 平台并管理数字资产。

关键规则

• - 按顺序完成所有工作流程步骤——切勿跳过步骤
• 始终为 curl 命令添加超时参数：-m 60
• 切勿重试失败的请求——报告错误并询问用户
• 在发布前检查项目状态以避免重复
• 封面 URL 必须是图片（jpg/png/webp），绝不能是视频 URL

多用户支持

将 API 密钥存储在 credentials/{USER_ID}.json 中：

json
{
x2cApiKey: x2cskxxx
}

调用时设置 USER_ID 环境变量。OpenClaw 会自动从聊天上下文中传递该变量。

或者设置 X2CAPIKEY 环境变量，或通过 ~/.openclaw/openclaw.json 中的 skills.x2c-publish.env.X2CAPIKEY 进行配置。

分发工作流程

1. 1. distribution/categories → 获取分类
2. distribution/upload-url → 获取 S3 预签名上传 URL
3. 通过 HTTP PUT 将文件上传到 S3
4. distribution/publish → 使用步骤 3 中的 public_url 提交
5. distribution/query → 检查审核状态
6. distribution/add-episodes → 添加更多剧集
7. distribution/list → 列出所有项目

提供视频的两种方式：

1. 1. S3 上传 — 对本地文件使用 upload-url 工作流程
2. 外部 URL — 在发布中直接使用现有视频 URL

API 端点

所有请求都发送到 X2C 开放 API。基础 URL 通过 X2CAPIBASE_URL 环境变量配置，或默认为生产环境端点。

请求头：

• - Content-Type: application/json
• X-API-Key: x2capi_key>

获取分类

bash
curl -m 60 -X POST $X2CAPIBASE_URL \
-H Content-Type: application/json \
-H X-API-Key: $X2CAPIKEY \
-d {action: distribution/categories, lang: zh-CN}

获取上传 URL

bash
curl -m 60 -X POST $X2CAPIBASE_URL \
-H Content-Type: application/json \
-H X-API-Key: $X2CAPIKEY \
-d {
action: distribution/upload-url,
files: [
{filetype: cover, filename: cover.jpg, content_type: image/jpeg},
{filetype: video, filename: ep1.mp4, content_type: video/mp4}
]
}

响应包含 uploadurl、uploadheaders 和 public_url。

上传到 S3

使用上一步响应中的 uploadurl 和 uploadheaders：

bash
curl -X PUT \
-H Content-Type: image/jpeg \
\
--data-binary @cover.jpg

发布项目

bash
curl -m 60 -X POST $X2CAPIBASE_URL \
-H Content-Type: application/json \
-H X-API-Key: $X2CAPIKEY \
-d {
action: distribution/publish,
title: 我的剧集,
description: 一个关于...的故事,
category_id: uuid,
cover_url: https://...,
video_urls: [https://...],
enable_prediction: false
}

查询状态

bash
curl -m 60 -X POST $X2CAPIBASE_URL \
-H Content-Type: application/json \
-H X-API-Key: $X2CAPIKEY \
-d {action: distribution/query, project_id: uuid}

状态值：draft（草稿）、pending_review（待审核）、approved（已批准）、rejected（已拒绝）

添加剧集

bash
curl -m 60 -X POST $X2CAPIBASE_URL \
-H Content-Type: application/json \
-H X-API-Key: $X2CAPIKEY \
-d {
action: distribution/add-episodes,
project_id: uuid,
video_urls: [https://...]
}

列出项目

bash
curl -m 60 -X POST $X2CAPIBASE_URL \
-H Content-Type: application/json \
-H X-API-Key: $X2CAPIKEY \
-d {action: distribution/list, page: 1, page_size: 20, status: approved}

钱包 API（资产管理）

获取余额

bash
curl -m 60 -X POST $X2CAPIBASE_URL \
-H Content-Type: application/json \
-H X-API-Key: $X2CAPIKEY \
-d {action: wallet/balance}

返回：credits、x2cwalletbalance、x2cpendingclaim、x2cpendingrelease、usdcbalance、walletaddress。

领取 X2C

bash
curl -m 60 -X POST $X2CAPIBASE_URL \
-H Content-Type: application/json \
-H X-API-Key: $X2CAPIKEY \
-d {action: wallet/claim-x2c, amount: 50.0}

将 X2C 兑换为 USDC

bash
curl -m 60 -X POST $X2CAPIBASE_URL \
-H Content-Type: application/json \
-H X-API-Key: $X2CAPIKEY \
-d {action: wallet/swap-x2c, amount: 100.0}

提取 USDC

bash
curl -m 60 -X POST $X2CAPIBASE_URL \
-H Content-Type: application/json \
-H X-API-Key: $X2CAPIKEY \
-d {action: wallet/withdraw-usdc, amount: 10.0, to_address: SolanaAddress...}

交易历史

bash
curl -m 60 -X POST $X2CAPIBASE_URL \
-H Content-Type: application/json \
-H X-API-Key: $X2CAPIKEY \
-d {action: wallet/transactions, page: 1, page_size: 20, type: all}

类型：earnings（收益，包括挖矿、分发、推荐等）、purchases（消费，包括消耗、兑换、提取等）或 all（全部）。