TikTok-Fotobeiträge und Karussells über die API: bis zu 35 Bilder
Die API for Business von TikTok veröffentlicht einen Fotobeitrag mit 1 bis 35 Bildern, jeweils eine JPG-, JPEG- oder WebP-Datei mit bis zu 20 MB und höchstens 1080 x 1920 Pixel, unabhängig von der Ausrichtung. TikTok lädt die Bilder von einer verifizierten URL herunter. Der Beitrag erhält einen Titel mit bis zu 90 Zeichen, eine Beschreibung, eine Sichtbarkeitsstufe und ein Cover-Bild.
easyCoexistence veröffentlicht TikTok-Fotobeiträge mit publish_tiktok_post aus Claude, ChatGPT oder Ihrem eigenen Code: Übergeben Sie 1 bis 35 Bildlinks, einen Titel und eine Beschreibung, und verfolgen Sie den Beitrag danach mit get_tiktok_publish_status.
Höchstzahl an Bildern, die ein einzelner Fotobeitrag über den Foto-Veröffentlichungsendpunkt von TikTok enthalten kann.
Größte Datei je Bild in einem Fotobeitrag, die JPG, JPEG oder WebP sein muss.
Höchste Bildauflösung in Pixeln für einen Fotobeitrag, oder 1920 x 1080 bei einem Querformatbild.
UTF-16-Codeeinheiten, die der Titel eines Fotobeitrags aufnehmen kann; für die Beschreibung sind bis zu 4,000 vorgesehen.
Was gehört in einen Fotobeitrag?
Ein Aufruf von POST /business/photo/publish/ enthält die Bilder und die Angaben zum Beitrag:
photo_images: bis zu 35 Bild-URLs auf einer verifizierten Domain oder einem URL-Präfix.photo_cover_index: das Bild, das als Cover dient, gezählt ab 0; das ist der Standardwert.post_info.title: bis zu 90 UTF-16-Codeeinheiten.post_info.caption: bis zu 4,000 UTF-16-Codeeinheiten, mit #Hashtags und höchstens 30 @Erwähnungen.post_info.privacy_level: wer den Beitrag sehen kann, innerhalb der Optionen, die die Einstellungen des Kontos zulassen.post_info.disable_comment: schaltet die Kommentare für den Beitrag aus.
Welche Bilddateien funktionieren?
JPG, JPEG oder WebP, jeweils bis zu 20 MB und höchstens 1080 x 1920 Pixel, bzw. 1920 x 1080 bei einem Querformatbild. TikTok prüft das Format erst nach dem Herunterladen der Datei, daher schlägt ein nicht unterstütztes Format später mit file_format_check_failed fehl. publish_tiktok_post lehnt Links, die auf .png, .gif, .bmp, .heic, .avif oder .svg enden, ab, bevor etwas gesendet wird.
Worin unterscheiden sich Titel und Beschreibung?
Es sind getrennte Felder mit getrennten Grenzen. Der Titel umfasst bis zu 90 UTF-16-Codeeinheiten. Die Beschreibung ist der Text des Beitrags, bis zu 4,000 Einheiten, und kann #Hashtags und @Erwähnungen der gegenseitigen Follower des Kontos enthalten, höchstens 30 davon. Beide werden in UTF-16-Codeeinheiten gezählt, sodass ein Emoji zwei oder mehr zählen kann. publish_tiktok_post übernimmt sie als title und caption.
Wer sieht den Beitrag, und können Personen kommentieren?
privacy_level bestimmt, wer ihn sieht: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR oder SELF_ONLY, innerhalb der Optionen, die GET /business/video/settings/ für das Konto zurückgibt. TikTok bietet PUBLIC_TO_EVERYONE nur für öffentliche Konten an, und diese Stufe setzt publish_tiktok_post. Kommentare sind aktiv, solange disable_comment nicht true ist; ein Konto, das von niemandem Kommentare annimmt, akzeptiert nur true.
Was passiert nach dem Aufruf?
TikTok gibt eine share_id zurück und lädt die Bilder im Hintergrund herunter. get_tiktok_publish_status nimmt diese share_id entgegen und meldet PROCESSING_DOWNLOAD, solange TikTok die Bilder abruft, PUBLISH_COMPLETE, sobald der Beitrag die Moderation bestanden hat, oder FAILED mit einem Grund wie photo_pull_failed. TikTok begrenzt Fotobeiträge über diesen Endpunkt auf sechs pro Minute und 15 pro Tag und Konto.
Häufige Fehler
- PNG-Bilder senden. TikTok-Fotobeiträge akzeptieren nur JPG, JPEG oder WebP, also die Dateien vor dem Veröffentlichen konvertieren.
- Den Titel nach den sichtbaren Zeichen zählen. TikTok zählt UTF-16-Codeeinheiten, daher erreicht ein Titel mit Emojis das Limit von 90 früher.
- Bilder über 1080 x 1920 Pixel verwenden. Das ist die größte Auflösung für Fotobeiträge bei TikTok, also größere Bilder zuerst verkleinern.
- Das Cover an eine andere Stelle als an die erste setzen. publish_tiktok_post verwendet das erste Bild als Cover.
Fotobeiträge lassen sich auch zu einem Datum und einer Uhrzeit Ihrer Wahl aus einer eigenen Warteschlange versenden. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung. Die ersten 3 Tage sind Teil der kostenlosen Testphase.
Häufig gestellte Fragen
Wie viele Fotos kann ein TikTok-Beitrag über die API haben?
Bis zu 35, jeweils eine JPG-, JPEG- oder WebP-Datei mit höchstens 20 MB.
Kann ein TikTok-Fotobeitrag PNG-Bilder verwenden?
Nein. Der Foto-Endpunkt akzeptiert JPG, JPEG und WebP, und TikTok lehnt ein PNG nach dem Herunterladen mit file_format_check_failed ab.
Wie lang darf der Titel eines Fotobeitrags sein?
Bis zu 90 UTF-16-Codeeinheiten. Die Beschreibung ist ein eigenes Feld und umfasst bis zu 4,000.
Welches Bild wird zum Cover?
Das Bild, auf das photo_cover_index zeigt, gezählt ab 0. publish_tiktok_post belässt den Wert bei 0, daher ist das erste Bild das Cover.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am