x2c-publish
X2c-Publish - X2C Distribution API
Publish video content to X2C platform using the Distribution API.
🔐 账号绑定流程
在发布视频之前，用户必须先绑定X2C账号。
绑定步骤：
- 打开 https://www.x2creel.ai 注册/登录账号
- 进入 个人中心 → API管理
- 创建并复制 API Key
- 将 API Key 发送给我
示例对话：
用户：我想发布视频
助手：好的，需要先绑定X2C账号。请打开 https://www.x2creel.ai 登录，然后在个人中心获取API Key发给我。
用户：x2c_sk_xxx...
助手：验证通过！你的账号已绑定，现在可以发布视频了～
Agent 自动验证
Agent 收到 API Key 后，直接调用 X2C API 验证：
- 验证成功 → 保存到
credentials/{USER_ID}.json - 验证失败 → 提示用户检查Key是否正确
⚠️ 重要规则
在用户提供有效的 X2C API Key 之前，禁止执行任何发布操作！
⚠️ 用户发布视频时的交互流程
当用户说"发布视频"或类似意图时，必须按以下流程执行：
Step 1: 立即获取并展示支持的分类
调用 distribution/categories API 获取支持的分类，直接展示给用户选择。
Step 2: 展示完整参数列表
告诉用户需要准备的信息：
| 参数 | 说明 | 示例 |
|---|---|---|
| 视频链接 | 视频的URL (mp4) | https://v.arkfs.co/.../video.mp4 |
| 封面图 | 视频封面URL (jpg/png/webp) 必填 | https://.../cover.jpg |
| 标题 | 作品名称 (最长10字) | 《重生千金》 |
| 简介 | 剧情简介 (最长200字) | 女主重生归来复仇... |
| 分类 | 从Step 1获取的分类中选择 | 都市复仇 |
Step 3: 收集完成后执行发布
用户确认所有参数后，调用 distribution/publish 执行发布。
⚠️ CRITICAL RULES - MUST FOLLOW THIS WORKFLOW
You MUST complete ALL steps in order. Never skip steps!
ALWAYS add timeout to curl commands: Use -m 60 (60 seconds max)
Step 1: distribution/categories → Get categories
Step 2: distribution/upload-url → Get S3 upload URLs (for cover + videos)
Step 3: Upload files to S3 via HTTP PUT (cover + videos)
Step 4: distribution/publish → Submit with the public_url from Step 3
Two ways to provide videos:
- S3 Upload - Use upload-url workflow (for local files)
- External URL - Use existing video URLs directly in publish (e.g., from AI Director)
NEVER retry failed requests! If a request fails, report the error to user and ask what to do. Do NOT automatically retry.
⚠️ 发布限制规则 (Publishing Restrictions)
-
不重复发布 (No Duplicate Publishing)
- 发布前必须先查询项目状态，确认未发布过
- 使用
distribution/query检查项目是否已发布 - 如果已发布，不要再次调用
distribution/publish
-
封面图片要求 (Cover Image Requirements)
cover_url必须是图片链接 (jpg/png/webp)- 不能使用视频链接作为封面
- 必须先获取视频的缩略图或上传封面图片
-
API 超时处理 (Timeout Handling)
- 添加超时参数
-m 60到 curl 命令 - 超时后不要自动重试，询问用户如何处理
- 添加超时参数
-
已发布项目的后续集数 (Adding Episodes)
- 如果项目已发布，需要添加新集数
- 使用
distribution/add-episodes而不是重新发布整个项目
API Endpoint
POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api
Headers:
Content-Type: application/jsonX-API-Key: x2c_sk_xxx...
Workflow
1. distribution/categories → Get available categories
2. distribution/upload-url → Get S3 presigned upload URLs
3. Upload files to S3 via HTTP PUT
4. distribution/publish → Submit project with metadata
5. distribution/query → Check review status
6. distribution/add-episodes → Add more episodes
7. distribution/list → List all projects
Commands
1. Get Categories
curl -X POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api \
-H "Content-Type: application/json" \
-H "X-API-Key: x2c_sk_xxx" \
-d '{
"action": "distribution/categories",
"lang": "zh-CN"
}'
⚠️ 必须使用 API 返回的分类！发布前必须先调用此 API 获取支持的分类列表，用户只能从返回的分类中选择。
2. Get Upload URLs
curl -X POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api \
-H "Content-Type: application/json" \
-H "X-API-Key: x2c_sk_xxx" \
-d '{
"action": "distribution/upload-url",
"files": [
{"file_type": "cover", "file_name": "cover.jpg", "content_type": "image/jpeg"},
{"file_type": "video", "file_name": "ep1.mp4", "content_type": "video/mp4"}
]
}'
Response includes:
upload_url- S3 URL to upload toupload_headers- Headers for PUT requestpublic_url- URL after upload completes
3. Upload to S3
curl -X PUT "<upload_url>" \
-H "Content-Type: image/jpeg" \
-H "Host: s3api.arkfs.co" \
-H "x-amz-content-sha256: UNSIGNED-PAYLOAD" \
-H "x-amz-date: 20260214T120000Z" \
-H "Authorization: AWS4-HMAC-SHA256 ..." \
--data-binary @cover.jpg
4. Publish Project
curl -X POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api \
-H "Content-Type: application/json" \
-H "X-API-Key: x2c_sk_xxx" \
-d '{
"action": "distribution/publish",
"title": "My Drama",
"description": "A story about...",
"category_id": "uuid",
"cover_url": "https://v.arkfs.co/.../cover.jpg",
"video_urls": ["https://v.arkfs.co/.../1.mp4"],
"enable_prediction": false
}'
Parameters:
| Param | Required | Description |
|---|---|---|
| title | Yes | Project name (max 100 chars) |
| description | Yes | Synopsis (max 2000 chars) |
| category_id | Yes | Category UUID (必须从 distribution/categories API 获取) |
| cover_url | Yes | Cover image URL |
| video_urls | Yes | Array of video URLs (1-10) |
| enable_prediction | No | Enable prediction market |
⚠️ 发布前必须先调用 distribution/categories 获取支持的分类，用户只能从中选择。
5. Query Status
curl -X POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api \
-H "Content-Type: application/json" \
-H "X-API-Key: x2c_sk_xxx" \
-d '{
"action": "distribution/query",
"project_id": "uuid"
}'
Status values:
draft- Created but not submittedpending_review- Awaiting reviewapproved- Liverejected- Rejected
6. Add Episodes
curl -X POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api \
-H "Content-Type: application/json" \
-H "X-API-Key: x2c_sk_xxx" \
-d '{
"action": "distribution/add-episodes",
"project_id": "uuid",
"video_urls": ["https://v.arkfs.co/.../3.mp4"]
}'
7. List Projects
curl -X POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api \
-H "Content-Type: application/json" \
-H "X-API-Key: x2c_sk_xxx" \
-d '{
"action": "distribution/list",
"page": 1,
"page_size": 20,
"status": "approved"
}'
Multi-User Support
API Key: Get from https://storyclaw.com/ (not alpaca.markets!)
Store in:
credentials/{USER_ID}.json
{
"x2cApiKey": "x2c_sk_xxx"
}
When calling, set USER_ID environment variable or pass via TELEGRAM_USER_ID.
Wallet API (Asset Management)
Query balances, claim X2C, swap to USDC, withdraw, and view transaction history.
Workflow
1. wallet/balance → Check all balances (credits, X2C, USDC)
2. wallet/claim-x2c → Claim released X2C to on-chain wallet
3. wallet/swap-x2c → Swap X2C tokens for USDC
4. wallet/withdraw-usdc → Withdraw USDC to external address
5. wallet/transactions → View earnings & purchase history
Commands
1. Get Wallet Balance
curl -X POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api \
-H "Content-Type: application/json" \
-H "X-API-Key: x2c_sk_xxx" \
-d '{"action": "wallet/balance"}'
Response:
| Field | Type | Description |
|---|---|---|
| credits | number | Platform credit balance |
| x2c_wallet_balance | number | On-chain X2C wallet balance |
| x2c_pending_claim | number | Released X2C available to claim |
| x2c_pending_release | number | Locked X2C not yet released |
| usdc_balance | number | USDC balance |
| wallet_address | string | Solana wallet address |
2. Claim X2C
curl -X POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api \
-H "Content-Type: application/json" \
-H "X-API-Key: x2c_sk_xxx" \
-d '{
"action": "wallet/claim-x2c",
"amount": 50.0
}'
Parameters:
| Param | Required | Description |
|---|---|---|
| amount | Yes | Amount of X2C to claim |
3. Swap X2C to USDC
curl -X POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api \
-H "Content-Type: application/json" \
-H "X-API-Key: x2c_sk_xxx" \
-d '{
"action": "wallet/swap-x2c",
"amount": 100.0
}'
4. Withdraw USDC
curl -X POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api \
-H "Content-Type: application/json" \
-H "X-API-Key: x2c_sk_xxx" \
-d '{
"action": "wallet/withdraw-usdc",
"amount": 10.0,
"to_address": "ExternalSolanaAddress..."
}'
Parameters:
| Param | Required | Description |
|---|---|---|
| amount | Yes | USDC amount to withdraw |
| to_address | Yes | Destination Solana wallet address |
5. Transaction History
curl -X POST https://eumfmgwxwjyagsvqloac.supabase.co/functions/v1/open-api \
-H "Content-Type: application/json" \
-H "X-API-Key: x2c_sk_xxx" \
-d '{
"action": "wallet/transactions",
"page": 1,
"page_size": 20,
"type": "all"
}'
Parameters:
| Param | Required | Description |
|---|---|---|
| page | No | Page number (default: 1) |
| page_size | No | Items per page (default: 20, max: 100) |
| type | No | "earnings", "purchases", or "all" (default) |
Earnings types: mining, distribution, referral, commission, copyright, x2c_release, x2c_claim
Purchase types: consume, ai_clone, drama_purchase, purchase, pre_charge, script_generate, preview_regen, ai_consume, swap, withdrawal
More from giggle-official/skills
giggle-generation-drama
Use this feature when users want to generate videos, shoot short films, or view available video styles. Triggering keywords: short film, make video, shoot short film, short video, AI video, generate video from story, short drama, narrated video, cinematic video, available video styles.
66giggle-generation-image
Supports text-to-image and image-to-image. Use when the user needs to create or generate images. After submit, proactively poll task status every ~15–30s and message the user each time until completed/failed/timeout—do not wait for the user to ask for progress. Use cases: (1) Generate from text description, (2) Use reference images, (3) Customize model, aspect ratio, resolution. Triggers: generate image, draw, create image, AI art.
63giggle-generation-aimv
Use when the user wants to create AI music videos (MV)—including generating music from text prompts or using custom lyrics. Before blocking on execute_workflow, tell the user the MV pipeline is running until completion; after return, immediately forward the result—user need not ask for progress. Triggers: generate MV, music video, make video for this song, lyrics video, create MV, AI music video, music+video, generate video from lyrics.
59giggle-generation-video
Supports text-to-video and image-to-video conversion (start frame/end frame). Trigger words: text-to-video, image-to-video.
58giggle-generation-music
Use when the user wants to create, generate, or compose music—whether from text description, custom lyrics, or instrumental background music. After submit, proactively poll task status every ~15–30s and message the user each time until completed/failed/timeout—do not wait for the user to ask for progress. Triggers: generate music, write a song, compose, create music, AI music, background music, instrumental, beats.
56giggle-generation-speech
Use when the user wants to generate speech, voiceover, or text-to-audio. Converts text to AI voice via Giggle.pro TTS API. Keep the user informed until audio is ready: message before long waits, use Cron/sync poll so the user need not ask for progress. Triggers: generate speech, text-to-speech, TTS, voiceover, read this text aloud, synthesize speech.
55