Social Media Publishing API

Social Media Publishing API

Verwenden Sie die Social Media Publishing API, um Social-Media-Konten zu verbinden und WayinVideo-Clips direkt auf diesen Konten zu veröffentlichen.

Diese API ist für exportierte Clips gedacht, die mit KI-Clipping und Momente finden erstellt wurden. Erstellen Sie zuerst Clips mit einer dieser APIs und stellen Sie sicher, dass das ursprüngliche Projekt mit enable_export = true eingereicht wurde. Verwenden Sie danach die resultierende project_id und den Clip-idx, wenn Sie eine Veröffentlichungsaufgabe erstellen.

Typischer Ablauf:

1. Erstellen Sie eine OAuth-Autorisierungs-URL für die Plattform, die Sie verbinden möchten.
2. Öffnen Sie die zurückgegebene auth_url in einem Browser und schließen Sie die Autorisierung ab.
3. Rufen Sie den Konten-Endpoint auf, um das verbundene Konto zu bestätigen und dessen id zu kopieren.
4. Erstellen Sie eine Veröffentlichungsaufgabe mit dem Zielclip und den kontospezifischen Veröffentlichungseinstellungen.

Alle Endpoints erfordern:

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

Abrechnung: Während der zeitlich begrenzten Promotion kostet das erfolgreiche Verbinden eines Social-Media-Kontos derzeit 10 API Units. Wenn die Autorisierung nicht erfolgreich abgeschlossen wird, werden keine API Units abgezogen.

Endpoints

Social-Media-Konto Verbinden

Erstellen Sie eine OAuth-Autorisierungs-URL für die Plattform, die Sie verbinden möchten.

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

Pfadparameter

Request Body

Es ist kein Request Body erforderlich.

Beispiel-Request

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 ''

Beispiel-Response

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

Response-Felder

Hinweise

• Jede auth_url kann nur einmal verwendet werden. Wenn die Autorisierung fehlschlägt oder die URL abläuft, rufen Sie diesen Endpoint erneut auf, um eine neue URL zu erstellen.
• Nach erfolgreicher Autorisierung rufen Sie Social-Media-Konten Auflisten auf, um zu bestätigen, dass das Konto für Veröffentlichungen verfügbar ist.
• Sie können mehrere Konten auf derselben Plattform verbinden. Rufen Sie zum Beispiel den YouTube-OAuth-Endpoint mehrfach auf, um mehrere YouTube-Kanäle zu verbinden.
• Wenn das Konto nicht erfolgreich verbunden wird, werden keine API Units abgezogen.

Social-Media-Konten Auflisten

Rufen Sie alle verbundenen Social-Media-Konten des aktuellen API-Key-Inhabers ab. Verwenden Sie diesen Endpoint vor dem Veröffentlichen, um die Konto-id-Werte für publish_configs zu finden.

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

Query-Parameter

Beispiel-Request

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"

Response, Wenn Kein Konto Verbunden Ist

{
  "data": []
}

Wenn data leer ist, rufen Sie zuerst Social-Media-Konto Verbinden auf.

Response, Wenn Konten Verbunden Sind

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

Response-Felder

Empfohlene Verwendung

• Bestätigen Sie vor dem Erstellen einer Veröffentlichungsaufgabe, dass das Zielkonto token_valid: true hat.

Veröffentlichungsaufgabe Erstellen

Veröffentlichen Sie einen Clip auf einem oder mehreren verbundenen Social-Media-Konten. Identifizieren Sie den Clip über die Projekt-ID und den Clip-Index.

Erforderlich: Die project_id muss aus einer KI-Clipping- oder Momente-finden-Aufgabe stammen, die mit enable_export = true eingereicht wurde. Social Publishing erfordert ein exportiertes Clip-Video; Projekte ohne aktivierten Export können mit diesem Endpoint nicht veröffentlicht werden.

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

Request-Felder

So erzeugen Sie einen scheduled_at-Wert

scheduled_at ist ein Unix-Timestamp in Millisekunden. Er muss mindestens 5 Minuten und höchstens 30 Tage in der Zukunft liegen.

Veröffentlichung in 10 Minuten mit JavaScript planen:

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

Für einen bestimmten Zeitpunkt planen:

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

Plattform-Veröffentlichungskonfiguration

Jeder Wert in publish_configs ist ein plattformspezifisches Veröffentlichungsobjekt.

Wichtig: Die Keys in publish_configs müssen Konto-IDs sein, die von /api/v2/social-media/accounts zurückgegeben wurden, z. B. smacct06ixxxxxxx. Verwenden Sie nicht youtube, tiktok oder andere Plattformnamen als Keys.

Beispiel-Request

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
  }'

Beispiel-Response

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

Response-Felder

Sie können Veröffentlichungspläne und Live-Ergebnisse im WayinVideo-Kalender ansehen.

Plattformwerte

Veröffentlichungsstatuswerte

Vollständiges Ablaufbeispiel

Schritt 1: YouTube-OAuth-URL Erstellen

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 ''

Öffnen Sie die zurückgegebene auth_url im Browser und schließen Sie die Autorisierung ab.

Schritt 2: Verfügbare Konten Auflisten

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"

Kopieren Sie die id des Kontos, auf dem Sie veröffentlichen möchten.

Schritt 3: Clip Veröffentlichen

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
  }'

Hinweise

1. Die Keys von publish_configs sind Konto-IDs, keine Plattformnamen.
2. Für geplante Veröffentlichungen übergeben Sie scheduled_at als zukünftigen Millisekunden-Timestamp.
3. Derselbe Clip kann mehrfach auf verschiedenen Konten veröffentlicht werden. Eine erneute Veröffentlichung desselben Clips auf demselben Konto erstellt eine unabhängige Aufgabe.
4. Social Publishing erfordert ein exportiertes Clip-Video. Verwenden Sie die project_id einer KI-Clipping- oder Momente-finden-Aufgabe, die mit enable_export = true erstellt wurde.
5. Wenn beim Veröffentlichen ein Konto-Token-Fehler zurückgegeben wird, verbinden Sie das Social-Media-Konto erneut und versuchen Sie es noch einmal.