1 回の呼び出しで、レンダリング済みの動画を接続済みアカウントの指定した分に予約できます。カレンダーを読み返し、キューをステータスで絞り込み、実際に投稿された時刻は署名付き 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"4 つのフィールド。レンダリング済みファイル、投稿先、時刻、そして言葉。
video_id公開する動画。レンダリング済みである必要があります。キューが投稿するのはファイルであって、タイムラインではありません。
account_idどの接続済みアカウントに送るか。1 投稿につき 1 つの宛先なので、失敗が他を巻き込むことはありません。
scheduled_atいつ出すか。プラットフォームが受け付ける範囲であれば、今すぐでも構いません。
caption添えるキャプション。ハッシュタグやメンションは入力したまま、その中を一緒に運ばれます。
カレンダーは「今週何が出るか」に答え、リソースは「この動画はどうなったか」に答えます。どちらも絞り込めるので、追加のエンドポイントなしでダッシュボードが作れます。
GET /api/v1/social_accountsGET /api/v1/scheduled_postspublishing.calendar予約は約束であって結果ではありません。post.published はプラットフォームが受理した時点で発火します。部分的な公開でも発火し、その場合はアカウントごとの結果がペイロードに入ります。
post.publishedpost.failedできません。これは意図した設計です。OAuth トークンがサーバーの外に出ないよう、接続はダッシュボードで行います。API にできるのは一覧取得と投稿だけです。
投稿はエラー状態でキューに残り、post.failed が理由つきで発火します。あなたの知らないところで黙って再試行することはありません。
できます。宛先ごとに 1 回ずつ呼び出してください。分けておくことで、あるプラットフォームがキャプションを拒否しても他がすべて巻き添えになりません。
publishing.calendar が 2 つの日付の間の予約投稿を日ごとにまとめて返します。もっと細かく見たい場合は scheduled_posts リソースを status、platform、video_id で絞り込んでください。