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"
}| Pole | Wymagane | Opis |
|---|---|---|
| prompt | Tak | Co ma zawierać opis lub czego ma dotyczyć. Do 2000 znaków |
| platform | Nie | Utrzymuje 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"
}| Pole | Wymagane | Opis |
|---|---|---|
| prompt | Tak | Jak ma się zmienić opis |
| originalText | Tak | Opis do przepisania. Do 10000 znaków |
| platform | Nie | Ta sama lista co wyżej |
| partialText | Nie | Częś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.