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"