ソーシャルメディア公開 API

ソーシャルメディア公開 API

ソーシャルメディア公開 API を使うと、ソーシャルメディアアカウントを接続し、WayinVideo のクリップをそのアカウントへ直接公開できます。

この API は AI クリッピング と モーメント検索 で生成されたエクスポート済みクリップ向けです。先にいずれかの API でクリップを作成し、元のプロジェクトが enable_export = true で送信されていることを確認してください。その後、取得した project_id とクリップの idx を使って公開タスクを作成します。

基本的な流れ：

1. 接続したいプラットフォームの OAuth 認可 URL を作成します。
2. 返された auth_url をブラウザで開き、認可を完了します。
3. アカウント一覧 API を呼び出して、接続済みアカウントの id を確認します。
4. 対象クリップと公開設定を使って公開タスクを作成します。

すべてのエンドポイントで以下が必要です：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
x-wayinvideo-api-version: v2

課金： 期間限定プロモーション中は、ソーシャルメディアアカウントを 1 つ正常に接続するごとに 10 API Units を消費します。認可が正常に完了しなかった場合、API Units は消費されません。

エンドポイント

ソーシャルメディアアカウントを接続する

接続したいプラットフォームの OAuth 認可 URL を作成します。

POST https://wayinvideo-api.wayin.ai/api/v2/social-media/oauth/{platform}

パスパラメータ

リクエストボディ

リクエストボディは不要です。

リクエスト例

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/social-media/oauth/youtube \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-wayinvideo-api-version: v2" \
  --data ''

レスポンス例

{
  "data": {
    "auth_url": "https://example.com/oauth2/auth?xxxxxx",
    "state": "a49bc736-xxxxx"
  }
}

レスポンスフィールド

注意

• 各 auth_url は 1 回だけ使用できます。認可に失敗した場合や URL が期限切れになった場合は、再度この API を呼び出してください。
• 認可成功後、ソーシャルメディアアカウント一覧で接続結果を確認します。
• 同じプラットフォームで複数アカウントを接続できます。たとえば YouTube OAuth API を複数回呼び出すと、複数の YouTube チャンネルを接続できます。
• アカウント接続が成功しなかった場合、API Units は消費されません。

ソーシャルメディアアカウント一覧

現在の API Key 所有者に接続されているソーシャルメディアアカウントを取得します。公開前に、この API で publish_configs に使うアカウント id を確認してください。

GET https://wayinvideo-api.wayin.ai/api/v2/social-media/accounts?active_only={active_only}

クエリパラメータ

リクエスト例

curl -X GET "https://wayinvideo-api.wayin.ai/api/v2/social-media/accounts?active_only=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-wayinvideo-api-version: v2"

アカウント未接続時のレスポンス

{
  "data": []
}

data が空の場合は、先にソーシャルメディアアカウントを接続するを実行してください。

アカウント接続済みのレスポンス

{
  "data": [
    {
      "id": "smaccxxx",
      "platform": "youtube",
      "platform_username": "MyChannel",
      "platform_avatar": "https://example.com/avatar.jpg",
      "token_valid": true,
      "token_expiring_soon": false
    }
  ]
}

レスポンスフィールド

推奨事項

• 公開タスク作成前に、対象アカウントの token_valid が true であることを確認してください。

公開タスクを作成する

1 つのクリップを 1 つ以上の接続済みソーシャルメディアアカウントへ公開します。プロジェクト ID とクリップインデックスで対象クリップを指定します。

必須： project_id は、enable_export = true で送信された AI クリッピングまたはモーメント検索タスクのものを使用してください。ソーシャル公開にはエクスポート済みのクリップ動画が必要です。エクスポートを有効にせず作成されたプロジェクトは、この API では公開できません。

POST https://wayinvideo-api.wayin.ai/api/v2/social-media/publish

リクエストフィールド

scheduled_at 値の生成方法

scheduled_at はミリ秒単位の Unix タイムスタンプです。現在時刻から 5 分以上先、30 日以内である必要があります。

JavaScript で 10 分後に予約する例：

const scheduledAt = Date.now() + 10 * 60 * 1000;

特定の時刻を指定する例：

const scheduledAt = new Date('2026-06-15T10:00:00Z').getTime();

プラットフォーム別公開設定

publish_configs の各 value は、プラットフォーム別の公開設定オブジェクトです。

重要： publish_configs の key は /api/v2/social-media/accounts が返すアカウント ID（例：smacct06ixxxxxxx）である必要があります。youtube や tiktok などのプラットフォーム名を key にしないでください。

リクエスト例

curl -sS -X POST https://wayinvideo-api.wayin.ai/api/v2/social-media/publish \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{
    "project_id": "prj06ixxxxxxx",
    "idx": 0,
    "resolution": "1080p",
    "publish_configs": {
      "smacct06ixxxxxxx": {
        "title": "API Test Video",
        "description": "Posted by curl test",
        "tags": ["api", "test"],
        "visibility": "public"
      }
    },
    "scheduled_at": null
  }'

レスポンス例

{
  "data": {
    "task_id": "pubtask06ixxxxxxx",
    "status": "PENDING",
    "created_at": 1781251687210
  }
}

公開スケジュールとリアルタイム結果は WayinVideo calendar で確認できます。

プラットフォーム値

公開ステータス値

完全なフロー例

1. OAuth API を呼び出し、ブラウザで auth_url を開いて認可を完了します。
2. アカウント一覧 API を呼び出し、対象アカウントの id をコピーします。
3. project_id、idx、publish_configs を使って公開タスクを作成します。

注意事項

1. publish_configs の key は接続済みアカウント ID であり、プラットフォーム名ではありません。
2. 予約公開する場合は将来のミリ秒タイムスタンプを渡します。null または省略で即時公開です。
3. 予約公開時刻は 5 分以上先、30 日以内である必要があります。
4. ソーシャル公開にはエクスポート済みクリップ動画が必要です。enable_export = true で作成した AI クリッピングまたはモーメント検索タスクの project_id を使用してください。
5. 公開時にアカウント token エラーが返った場合は、対象ソーシャルメディアアカウントを再接続してから再試行してください。
6. 同じクリップは複数回公開できます。同じアカウントへ同じクリップを再度公開すると、別の公開タスクが作成されます。