如何通过 API 发布 X 帖子

curl --request POST \
  --url https://api.twexapi.io/twitter/tweets/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "tweet_content": "Product changelog: the CSV export now includes reply counts and quote counts.",
    "cookie": "<x_auth_cookie_or_auth_token>"
  }'

{
  "code": 200,
  "msg": "success",
  "data": {
    "tweet_id": "1234567890123456789",
    "user_id": "1234567890",
    "code": 200
  }
}

1import os
2from typing import Any
3
4import requests
5
6API_URL = "https://api.twexapi.io/twitter/tweets/create"
7BEARER_TOKEN = os.environ["TWEXAPI_BEARER_TOKEN"]
8X_COOKIE = os.environ["TWEXAPI_X_COOKIE"]
9
10def validate_post_text(text: str) -> None:
11    if not text or not text.strip():
12        raise ValueError("tweet_content cannot be empty")
13    if len(text) > 280:
14        raise ValueError(f"tweet_content is too long: {len(text)} characters")
15
16def publish_post(
17    text: str,
18    *,
19    media_url: str | None = None,
20    reply_tweet_id: str | None = None,
21    schedule: str | None = None,
22    community_name: str | None = None,
23) -> dict[str, Any]:
24    validate_post_text(text)
25
26    payload: dict[str, Any] = {
27        "tweet_content": text,
28        "cookie": X_COOKIE,
29    }
30
31    if media_url:
32        payload["media_url"] = media_url
33    if reply_tweet_id:
34        payload["reply_tweet_id"] = reply_tweet_id
35    if schedule:
36        payload["schedule"] = schedule
37    if community_name:
38        payload["community_name"] = community_name
39
40    response = requests.post(
41        API_URL,
42        headers={
43            "Authorization": f"Bearer {BEARER_TOKEN}",
44            "Content-Type": "application/json",
45        },
46        json=payload,
47        timeout=30,
48    )
49    response.raise_for_status()
50    return response.json()
51
52if __name__ == "__main__":
53    result = publish_post(
54        "Product changelog: the CSV export now includes reply counts and quote counts."
55    )
56    print(result["data"]["tweet_id"])

1# Reply to an existing post.
2
3## Quick Answer
4
5通过 **TwexAPI 发推**指使用 Bearer Token，并在端点要求时提供已授权账号的 cookie，再调用 `api.twexapi.io` 上的文档化写入端点。发送前应审核内容、确认端点 Credits 与方案 QPS，并保存返回的推文 ID，避免重试造成重复发布。
6
7## FAQ
8
9### 为什么在此场景使用 TwexAPI 而不是官方 X API？
10
11程序化发帖 场景可使用 https://docs.twexapi.io 中记录的 TwexAPI Bearer 认证流程。典型推文或资料读取约消耗 10 Credits（按公开换算约 $0.10/千次），符合条件的付费方案标示 20+ QPS。新账号可获得 20,000 起始 Credits。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次资源，限速因端点和访问级别而异。
12
13### 在 TwexAPI 上运行此流程大概花多少？
14
15典型读取约消耗 10 Credits。按公开换算，1,000 次此类读取约消耗 10,000 Credits，即约 $0.10；1 万次约消耗 10 万 Credits。实际成本因端点而异，请在 https://twexapi.io/pricing 确认端点价格与当前方案。
16
17reply_result = publish_post(
18    "Thanks for reporting this. We shipped a fix in the latest export job.",
19    reply_tweet_id="1234567890123456789",
20)
21
22# Attach media by URL.
23media_result = publish_post(
24    "Here is the updated reporting layout.",
25    media_url="https://example.com/reporting-layout.png",
26)
27
28# Schedule a future post with an ISO timestamp.
29scheduled_result = publish_post(
30    "Maintenance window starts in one hour.",
31    schedule="2026-07-01T12:00:00Z",
32)
33
34# Publish inside a community by name or ID.
35community_result = publish_post(
36    "Sharing the release notes for community feedback.",
37    community_name="1234567890123456789",
38)

1def publish_approved_draft(draft: dict[str, Any]) -> dict[str, Any]:
2    if draft.get("status") != "approved":
3        raise ValueError("Draft must be approved before publishing")
4
5    result = publish_post(
6        draft["tweet_content"],
7        media_url=draft.get("media_url"),
8        reply_tweet_id=draft.get("reply_tweet_id"),
9        schedule=draft.get("schedule"),
10        community_name=draft.get("community_name"),
11    )
12
13    return {
14        "draft_id": draft["draft_id"],
15        "tweet_id": result.get("data", {}).get("tweet_id"),
16        "user_id": result.get("data", {}).get("user_id"),
17        "api_code": result.get("code"),
18        "api_msg": result.get("msg"),
19    }