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: <你的x2capikey>

获取分类

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（X2C钱包余额）、x2cpendingclaim（待领取X2C）、x2cpendingrelease（待释放X2C）、usdcbalance（USDC余额）、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（全部）。