还没有输出。提交表单以生成内容。
透明定价,无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格(美元) | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
create-tweet otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
通过单一统一端点,以编程方式向任何已认证的 X (Twitter) 账号发布推文,完整支持文本、媒体附件、回复和敏感内容标记。

ApiPass 上的 Twitter Graphql Create Tweet API 是一个 POST 端点 (/api/v1/jobs/createTask),让开发者无需通过 Twitter 官方开发者计划审批流程,即可代表已认证的 Twitter/X 账号发布推文。通过传入已登录 Twitter 会话中的 auth_token cookie 以及推文负载,你可以发布纯文本推文、附加最多四个媒体项、回复现有推文、在媒体中标记用户、添加语义注释,并将内容标记为可能敏感。该 API 采用异步方式运行——每个请求都会返回一个 taskId,你可以通过 recordInfo 端点轮询,也可以在推文成功发布后通过 callback 接收结果。
跳过冗长的 Twitter Developer Platform 申请、提升访问权限审核和企业级门槛。使用标准 auth_token cookie 进行认证,即可立即开始发布。
ApiPass 会通过多个提供商(starter、regular、official)路由你的请求,价格远低于 Twitter 官方 Basic (200/month) 或 Pro (5,000/month) 套餐;默认的 auto channel 会实时自动选择最具性价比且稳定的提供商。
访问与 Twitter 网页客户端使用的相同内部 GraphQL mutation,包括 media_entities、tagged_users、semantic_annotation_ids、dark_request,以及旧版 REST 端点未开放的回复线程控制能力。
每次创建推文都会返回一个 taskId,你可以查询该任务,也可以通过 callBackUrl 接收结果,轻松构建高可用、高吞吐的发布流水线,而无需阻塞应用线程。
由于认证通过每个请求中的 AuthToken 完成,你可以用一个 API key 管理不限数量的 Twitter 账号——非常适合代理机构、社交媒体管理工具和多品牌发布场景。
一个 JSON 负载即可覆盖纯文本推文、媒体推文、回复和敏感内容发布。无需处理 multipart 上传、独立媒体端点,也无需为不同推文类型切换不同认证流程。
通过 media.media_entities 使用 media_id 引用附加已预上传的媒体,通过 tagged_users 在图片中标记用户,并在需要时将上传内容标记为 possibly_sensitive。
使用 reply.in_reply_to_tweet_id 将回复发布到现有对话中,并使用 reply.exclude_reply_user_ids 有选择地将参与者从回复通知链中静音。
可在 auto、starter、regular 和 official 通道之间选择,根据你的工作负载平衡成本、稳定性和速度——从超低成本批量发布到生产级 official-tier 可靠性都可覆盖。
构建类似 Buffer/Hootsuite 的工具,让用户连接自己的 X 账号,并可同时跨数十个账号定时发布推文、线程和媒体内容。
与 LLM 搭配使用,按计划或响应事件自动生成并发布推文、新闻摘要、市场动态或 AI 生成图像。
使用回复参数构建支持机器人,从品牌官方账号响应客户 @-mentions 或与工单关联的推文。
在更广泛的 CMS 或新闻编辑流程中,将 X 添加为输出渠道,使单次 "publish" 操作能够同步分发到 Twitter 以及其他社交网络。
虽然 Twitter 官方 POST /2/tweets 端点要求付费 Developer Account、OAuth 2.0 app 设置,并执行严格的按套餐速率限制,但 ApiPass 通过轻量级的基于 cookie 的认证模型,以按量计费方式提供相同的推文发布能力——集成速度大幅提升,扩展成本也更低。
Twitter 官方 POST /2/tweets 端点要求已获批准的 Developer Account、OAuth 2.0 app 设置,以及带有严格月度发帖上限的付费订阅套餐($200+/month)。ApiPass 只需要从已登录浏览器会话中提取的 auth_token cookie(F12 → Application → Cookies → auth_token)和一个 Bearer API key——无需应用注册、无需 OAuth callback URLs,也没有套餐门槛。
Twitter 官方 API 按套餐强制执行月度发帖限制(Basic 为 1,500/month,Pro 为 300,000/month),并收取固定订阅费用,不受实际使用量影响。ApiPass 按成功任务按量计费,并且 channel 参数允许你在成本与稳定性之间取舍——starter tier 对非关键工作负载来说便宜得多,而 official 则提供与原生 API 等价的定价和可靠性。
将突发新闻、价格提醒、天气预警或系统状态更新从监控流水线实时直接发布到品牌 X 账号。
自动发布每日 AI 生成图片、摘要、语录或线程式文章,在无需人工干预的情况下增长内容驱动型账号。
使用 in_reply_to_tweet_id 参数大规模回复提及、引用推文和线程后续内容,为抽奖机器人、FAQ 回复器或社区管理账号提供能力支持。
管理数十个客户账号的代理机构可以通过在每个请求中切换 AuthToken 来向任意账号发布内容,所有费用统一归集到一个 ApiPass key 下,并拥有统一日志。
注册 ApiPass,并从你的控制台生成 API key。然后打开 twitter.com,登录你要用于发布的账号,打开 DevTools (F12) → Application → Storage → Cookies,并复制 auth_token cookie 的值。该 token 授权 ApiPass 代表该特定账号发布内容。
向 https://api.apipass.dev/api/v1/jobs/createTask 发送 POST 请求,并在 Authorization header 中以 Bearer token 形式携带你的 ApiPass API key。在 JSON body 中,将 model 设置为 twitter/graphql/create-tweet,在 input object 中提供你的 AuthToken,并在 variables object 中至少填写 tweet_text field。你也可以选择包含 media.media_entities 用于图片或视频附件,包含 reply.in_reply_to_tweet_id 用于作为回复发布,并在希望 ApiPass 在完成时通知你的服务器时提供 callBackUrl。响应将返回一个 taskId,可用于跟踪该请求。
你可以在初始请求中提供 callBackUrl,以便在推文发布后收到通知;也可以轮询 GET /api/v1/jobs/recordInfo?taskId={taskId},直到 state 返回 success。resultJson field 将包含已发布推文的详细信息。可能的任务状态包括 waiting、queuing、generating、success 和 fail(适用时会返回 failCode 和 failMsg 用于调试)。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
发布一条推文。
该 API 接受具有以下结构的 JSON 负载:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "AuthToken": "string",
7 "variables": {
8 "tweet_text": "string",
9 "dark_request": "boolean",
10 "media": {
11 "media_entities": "[]",
12 "possibly_sensitive": "boolean",
13 },
14 "reply": {
15 "in_reply_to_tweet_id": "string",
16 "exclude_reply_user_ids": "[]",
17 },
18 "semantic_annotation_ids": "[]",
19 "includePromotedContent": "boolean",
20 }
21 }
22}model必填string用于生成的模型名称
"twitter/graphql/create-tweet"
callBackUrl可选string用于接收任务完成通知的回调 URL。如果省略,则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数在 APIPASS 中指定对应的提供商;这些提供商负责处理实际的图像和视频生成任务。APIPASS 目前提供三种提供商选项:
channel 参数的默认值为 auto。启用后,APIPASS 会根据实时价格和稳定性指标,在可用提供商之间自动分配任务,以平衡最低成本和可靠性能。除非你有自定义路由需求,否则请保留默认值 auto。
可用选项:
auto
input 对象包含以下参数:
input.variables.tweet_text必填stringhello
input.variables.dark_request可选booleanfalse
input.variables.media.media_entities可选array[]
input.variables.media.possibly_sensitive可选booleanfalse
input.variables.semantic_annotation_ids可选array[]
input.variables.includePromotedContent可选booleanfalse
variables.reply.in_reply_to_tweet_id可选string123
variables.reply.exclude_reply_user_ids可选string[]
input.AuthToken必填string打开 Twitter 首页并登录,然后前往 F12 > Application > Storage > Cookies > auth_token。

YOUR_X_AUTH_TOKEN
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "twitter/graphql/create-tweet",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "AuthToken": "YOUR_X_AUTH_TOKEN",
9 "variables": {
10 "tweet_text": "hello",
11 "dark_request": false,
12 "reply": {
13 "in_reply_to_tweet_id": "123",
14 "exclude_reply_user_ids": []
15 },
16 "media": {
17 "media_entities": [
18 {
19 "media_id": "1869610428579606520",
20 "tagged_users": []
21 }
22 ],
23 "possibly_sensitive": false
24 },
25 "semantic_annotation_ids": [],
26 "includePromotedContent": false
27 }
28 }
29 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code状态码,200 表示成功,其他表示失败
message响应消息,失败时为错误描述
data.taskId用于查询任务状态和结果的任务 ID