REST APIPOST

Caption generieren

Schreiben Sie eine Caption aus einem Prompt oder formulieren Sie eine vorhandene um, begrenzt auf das Zeichenlimit der angegebenen Plattform.

Zwei Endpunkte schreiben Ihren Beitragstext. Beide kosten pro Aufruf ein Caption-Guthaben, es sei denn, Sie haben einen eigenen Anbieterschlüssel verbunden. Dann laufen die Aufrufe über Ihren Schlüssel und kosten nichts.

POST /api/v1/ai/captions

POST /api/v1/ai/captions
{
  "prompt": "ankündigen, dass unser Scheduler jetzt auf Bluesky postet",
  "platform": "LINKEDIN"
}
FeldPflichtBeschreibung
promptJaWorum es in der Caption gehen soll. Bis zu 2000 Zeichen
platformNeinHält die Caption am Limit dieser Plattform. Ohne Angabe gilt eine Obergrenze von 2200 Zeichen
{
  "caption": "Bluesky ist jetzt dabei. Gleiche Warteschlange, gleicher Zeitplan, ein Ort mehr für Ihre Beiträge."
}

platform akzeptiert TWITTER, BLUESKY, THREADS, PINTEREST, INSTAGRAM, TIKTOK, LINKEDIN, YOUTUBE und FACEBOOK. Die Angabe macht einen Unterschied: Eine Caption für LinkedIn darf 3000 Zeichen lang sein, derselbe Prompt für X endet bei 280.

POST /api/v1/ai/captions/refine

POST /api/v1/ai/captions/refine
{
  "prompt": "halbiere den Text und entferne die Ausrufezeichen",
  "originalText": "Bluesky ist jetzt dabei! Gleiche Warteschlange, gleicher Zeitplan!",
  "platform": "BLUESKY"
}
FeldPflichtBeschreibung
promptJaWie sich die Caption ändern soll
originalTextJaDie umzuschreibende Caption. Bis zu 10000 Zeichen
platformNeinDieselbe Liste wie oben
partialTextNeinEine angefangene Caption, die fortgesetzt statt umgeschrieben wird

Die Antwort hat dieselbe Form wie bei der Generierung.

{
  "caption": "Bluesky ist jetzt dabei. Gleiche Warteschlange, gleicher Zeitplan."
}

Senden Sie partialText, wenn jemand zu tippen begonnen hat und den Rest geschrieben haben möchte. Lassen Sie es weg, wenn der ganze Text neu geschrieben werden soll.

Fehler

Ein 402 bedeutet, dass der Workspace keine Caption-Guthaben mehr hat. Verbinden Sie im Dashboard Ihren eigenen OpenAI- oder Anthropic-Schlüssel, dann verbrauchen die Aufrufe kein Guthaben mehr.

Beide Endpunkte zählen auf dasselbe Rate-Limit pro Schlüssel wie der Rest der API, und jede Antwort enthält RateLimit-Remaining, damit Sie einen Stapel takten können, ohne in ein 429 zu laufen.