# Threads-Text- und Bildbeiträge mit SosoAPI planen

Kanonische URL: https://sosoapi.ai/de/docs/threads-api-publishing

Plane einen Text- oder Bildbeitrag für ein verbundenes Threads-Konto und prüfe danach die Veröffentlichung. Die Beispiele nutzen Platzhalter und laufen nicht auf dieser Seite. Veröffentlichungsvertrag geprüft am 20 Oktober 2026.

## 1. Verbinden und Ziel prüfen

Verbinde das gewünschte Threads-Konto in SosoAPI. Die Anbieterzustimmung benötigt threads_content_publish zur Veröffentlichung. Der SosoAPI-Aufrufer benötigt außerdem einen erlaubten Workspace, editor-Zugriff und agent:publish zum Planen.

Prüfe, ob SosoAPI das gewünschte Threads-Konto geliefert hat. Führe vor dem Planen die Eignungsprüfung mit vollständigem Entwurf, Inhalt und Zeitpunkt aus. Antworten, Standorte und plattformübergreifendes Teilen haben zusätzliche Berechtigungs- und Eignungsanforderungen.

- [Plattformfunktionsmatrix prüfen](https://sosoapi.ai/de/docs/publishing-capabilities)

## 2. Einen geprüften Textbeitrag planen

Nutze den Server-Helper aus der API-Referenz, ersetze Platzhalter und wähle einen zukünftigen ISO-8601-Zeitpunkt mit Offset. Diese Anfrage erstellt einen echten Zeitplan; bestätige Konto, Formulierung und Zeitpunkt vor dem Senden.

Lasse für TEXT media leer. Behalte einen Idempotenzschlüssel für diese Anfrage und speichere post.id zur Statusprüfung. Nutze für dieses Konto einen Threads-provider_payload.

```
await sosoPost("/studio-api/scheduled-posts/create", {
  "workspace_id": "<workspace-uuid>",
  "social_account_id": "<threads-account-uuid>",
  "caption": "A reviewed update from our team.",
  "hashtags": [],
  "media": [],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {
      "post_type": "TEXT"
    }
  },
  "scheduled_at": "<future-ISO-8601-instant-with-offset>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<stable-key-for-this-one-intent>"
});
```

- [Veröffentlichungs-API-Referenz](https://sosoapi.ai/de/docs/publishing-api-reference)

## 3. Ein bereites registriertes Bild nutzen

Nutze für ein lokales Bild sosoapi_upload_asset. Rufe für eine öffentliche Bild-URL sosoapi_import_asset_url auf und prüfe sosoapi_get_asset_import_status bis zur Bereitschaft. Nutze ID und kanonische URL des registrierten Assets im Beitrag.

Setze für normale create-Anfragen post_type auf IMAGE und ergänze das bereite Bild in media. Das folgende Fragment ersetzt diese zwei Felder im Textbeispiel. Behalte Text, Konto und Zeitpunkt und nutze einen neuen stabilen Schlüssel für diesen neu bestätigten Beitrag.

- Ersetze asset_id durch die tatsächliche positive Ganzzahl, keinen numerischen String.

- Plane nicht mit Quell-URL, temporärer Vorschau-URL oder unfertigem Import.

- Dasselbe Bibliotheksbild darf nur bei passenden Rechten, Workspace und gewähltem Inhalt wiederverwendet werden.

```
{
  "media": [{
    "kind": "image",
    "asset_id": "<ready-image-asset-id-as-number>",
    "url": "<canonical-image-asset-url>"
  }],
  "provider_payload": {
    "platform": "threads",
    "publish_options": {"post_type": "IMAGE"}
  }
}
```

## 4. Veröffentlichung prüfen und doppelte Sendungen vermeiden

Lies den ursprünglichen Scheduled Post und prüfe sein endgültiges Veröffentlichungsergebnis. ID, angenommener Zeitplan oder Threads-Mediencontainer zeigen nur, dass die Anfrage existiert; sie bestätigen keine Veröffentlichung. Zeige verfügbare Anbieter-Beitrags-ID oder Permalink.

Verarbeitet Threads noch oder fehlt die Antwort, prüfe denselben Beitrag weiter. Sende keine weitere create-Anfrage mit anderem Schlüssel. Erneutes Verbinden klärt nicht, ob ein früherer Schreibvorgang erfolgreich war.

Sobald Threads einen Textbeitrag veröffentlicht, ist der Anbieterschritt eventuell nicht mehr umkehrbar. Folge den von SosoAPI gelieferten verfügbaren Aktionen, statt erneut zu senden. Verarbeitungszeit kann variieren.

- [Mit Claude Code oder Codex prüfen](https://sosoapi.ai/de/docs/claude-code-codex-social-publishing)

- [Veröffentlichungs-API-Referenz](https://sosoapi.ai/de/docs/publishing-api-reference)