REST APIPOST

Generuj opis

Napisz opis na podstawie polecenia albo przepisz istniejący, z zachowaniem limitu znaków wskazanej platformy.

Uprawnienie: ai.generate. Zobacz Role i uprawnienia.

Dwa endpointy piszą teksty postów. Każde wywołanie kosztuje jeden kredyt na opisy, chyba że masz podłączony własny klucz dostawcy: wtedy działają na twoim kluczu i nic nie kosztują.

POST /api/v1/ai/captions

POST /api/v1/ai/captions
{
  "prompt": "announce that our scheduler now posts to Bluesky",
  "platform": "LINKEDIN"
}
PoleWymaganeOpis
promptTakCo ma zawierać opis lub czego ma dotyczyć. Do 2000 znaków
platformNieUtrzymuje opis w limicie tej platformy. Bez tego pola limit to 2200 znaków
{
  "caption": "Bluesky just joined the list. Same queue, same schedule, one more place your posts land."
}

platform przyjmuje TWITTER, BLUESKY, MASTODON, THREADS, PINTEREST, INSTAGRAM, TIKTOK, LINKEDIN, YOUTUBE, FACEBOOK, GOOGLE_BUSINESS, TUMBLR i WORDPRESS. Warto ją podać: opis napisany na LinkedIn może mieć do 3000 znaków, a to samo polecenie dla X kończy się na 280.

POST /api/v1/ai/captions/refine

POST /api/v1/ai/captions/refine
{
  "prompt": "cut it in half and drop the exclamation marks",
  "originalText": "Bluesky just joined the list! Same queue, same schedule!",
  "platform": "BLUESKY"
}
PoleWymaganeOpis
promptTakJak ma się zmienić opis
originalTextTakOpis do przepisania. Do 10000 znaków
platformNieTa sama lista co wyżej
partialTextNieCzęściowo napisany opis do dokończenia zamiast przepisania

Odpowiedź ma taki sam kształt jak przy generowaniu.

{
  "caption": "Bluesky just joined the list. Same queue, same schedule."
}

Wyślij partialText, gdy ktoś zaczął pisać i chce, aby dopisać resztę. Pomiń to pole, gdy całość ma zostać przepisana.

Błędy

402 oznacza, że w obszarze roboczym skończyły się kredyty na opisy. Podłącz w panelu własny klucz OpenAI lub Anthropic, a wywołania przestaną zużywać kredyty.

Oba endpointy wliczają się do tego samego limitu zapytań na klucz co reszta API, a każda odpowiedź zawiera RateLimit-Remaining, więc możesz dostosować tempo partii i uniknąć błędu 429.