X (Twitter) Post Helper - Text, Image, Video in One Call

Post tweets to X (Twitter) in one REST call. Send text only, or attach an image or video by URL. The API handles OAuth signing, chunked media upload, and X v2 tweet creation server-side. Returns the live tweet URL.

原始信息汇总

X (Twitter) Post Helper - Text, Image, Video in One Call

这是一个将发布推文（含文字、图片、视频）的复杂多步 Twitter API 流程简化为单个 HTTP 请求的 API。

核心功能

• 一键发布：通过一个 POST 请求即可发布纯文本推文，或附带图片/视频。
• 自动媒体处理：服务器端自动处理 OAuth 签名、多媒体分块上传、视频处理状态轮询等步骤。
• 返回结果：返回包含推文 URL、推文 ID 和媒体 ID 的标准化 JSON 响应。

请求方法

• 端点：POST createPost
• 请求字段（所有字段为字符串格式）：

字段	类型	必填	描述
consumer_key	string	是	X OAuth 1.0a 消费者密钥
consumer_secret	string	是	X OAuth 1.0a 消费者机密
access_token	string	是	发布账户的 X OAuth 1.0a 访问令牌
access_token_secret	string	是	发布账户的 X OAuth 1.0a 访问令牌机密
text	string	是	推文文本，最多 280 个字符
media_url	string	否	要附加的图片（jpg, png, webp, gif）或视频（mp4）的 URL

请求示例

json { "consumer_key": "YOUR_X_CONSUMER_KEY", "consumer_secret": "YOUR_X_CONSUMER_SECRET", "access_token": "YOUR_X_ACCESS_TOKEN", "access_token_secret": "YOUR_X_ACCESS_TOKEN_SECRET", "text": "Posted via the helper API.", "media_url": "https://example.com/video.mp4" }

响应示例

json { "tweet_url": "https://x.com/i/web/status/1234567890", "tweet_id": "1234567890", "media_id": "9876543210" }

错误码

• 400：验证错误（缺少字段或文本超过 280 字符）
• 401：OAuth 凭证被 X 拒绝（密钥错误或权限不足）
• 415：媒体 URL 不是支持的图片或视频类型
• 502：X 在上传或发布过程中返回错误
• 504：视频处理超时

注意事项

• 推文将发布到提供的访问令牌所对应的账户。
• 视频文件约 5 MB 以下通常在一个 APPEND 段内完成；较大文件仍可工作但耗时更长。
• 服务器会轮询 X 的媒体状态直到处理成功，然后创建推文。
• 推文字数限制为 280 个字符（由 X 平台设定）。

定价方案

• BASIC：$0.00/月
• PRO：$10.00/月
• ULTRA：$25.00/月
• MEGA：$99.00/月