X (Twitter) API Python media tweets & DM attachments

import json
import sys
from typing import Any

from x_twitter_scraper import XTwitterScraper

client = XTwitterScraper()

def create_tweet_handoff(
    action: dict[str, Any],
    base: dict[str, Any],
) -> dict[str, Any]:
    result = action.get("result") or {}
    return {
        "status": action["status"],
        "terminal": action["terminal"],
        "safe_to_retry": action["safeToRetry"],
        "write_action_id": action["id"],
        "request_hash": action["request"]["hash"],
        "tweet_id": result.get("id") or action.get("tweetId"),
        "charged": action["billing"]["charged"],
        "charged_credits": action["billing"]["chargedCredits"],
        "poll": None if action["terminal"] else action["statusUrl"],
        **base,
    }

response = client.x.tweets.with_raw_response.create(
    account="@username",
    text="New demo video is live.",
    media=["https://example.com/product-demo.mp4"],
)
payload = response.json()

tweet_handoff = create_tweet_handoff(
    payload,
    {
        "account": "@username",
        "media": ["https://example.com/product-demo.mp4"],
    },
)

sys.stdout.write(json.dumps(tweet_handoff, ensure_ascii=False) + "\n")

response = client.x.tweets.with_raw_response.create(
    account="@username",
    text="Here is the requested screenshot.",
    reply_to_tweet_id="1893704267862470862",
    media=["https://example.com/export-preview.png"],
)
payload = response.json()

reply_handoff = create_tweet_handoff(
    payload,
    {
        "account": "@username",
        "reply_to_tweet_id": "1893704267862470862",
        "media": ["https://example.com/export-preview.png"],
    },
)

sys.stdout.write(json.dumps(reply_handoff, ensure_ascii=False) + "\n")

import json
import sys
from pathlib import Path

media = client.x.media.upload(
    account="@username",
    file=Path("./handoff.png"),
)

dm = client.x.dm.send(
    user_id="44196397",
    account="@username",
    text="Here is the asset.",
    media_ids=[media.media_id],
)

dm_handoff = {
    "status": "sent",
    "message_id": dm.message_id,
    "media_id": media.media_id,
    "account": "@username",
    "user_id": "44196397",
}

sys.stdout.write(json.dumps(dm_handoff, ensure_ascii=False) + "\n")