API社交媒體發布 API

把成片排進發布計劃
不用打開任何後台

一次調用就把渲染好的視頻排到某個已連接賬號上，精確到你選的那一分鐘。回讀日曆、按狀態過濾隊列，真正發出去的時刻由簽名 Webhook 告訴你。

POSThttps://autostud.ai/api/v1/actions/publishing.schedule_post

三次調用，從渲染到發布

目標賬號只找一次，之後想排多少就排多少。

找到發布目標

已連接賬號在 API 裡是只讀的：它們只在後台連接一次，因為 OAuth 憑據絕不能離開服務器。列出它們，記住 id。

export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Read-only on purpose: accounts are connected from the dashboard,
# so the OAuth tokens never leave the server.
curl "https://autostud.ai/api/v1/social_accounts?status=active&limit=10" \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY"

排入發布計劃

一個視頻、一個賬號、一個時刻和一段文案。調用返回的是排隊中的帖子，不是已發布的帖子，所以真實來源仍然是你自己的調度器。

curl -X POST https://autostud.ai/api/v1/actions/publishing.schedule_post \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lighthouse-ep12-tiktok" \
  -d '{
    "video_id": "0f4c8b71-2d95-47a3-9e6c-15b8ad7f3c20",
    "account_id": "9a2c6f18-4b70-4d35-8e91-0f7d3c84b562",
    "scheduled_at": "2026-08-21T18:30:00.000Z",
    "caption": "Episode 12: the keeper who never slept #lighthouse"
  }'

看著它發出去

按天分組讀日曆，按狀態過濾隊列，或者接住 post.published 然後不必再問。失敗也走同一條路，並附上原因。

curl -X POST https://autostud.ai/api/v1/actions/publishing.calendar \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "from": "2026-08-17", "to": "2026-08-24" }'

# Need something more specific? The queue is a plain resource:
curl "https://autostud.ai/api/v1/scheduled_posts?status=error&platform=tiktok" \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY"