Skip to Content
Cut.ProDocs
Posting: social media posts

Write the post description with AI

Writes the text that goes with the post (caption, description, title) from what is said in the clip (edit_id), the images (image_ids) or a title, for each network in platforms, ready to drop in the metadata of POST /posts. Nothing is saved or posted.

The style is style when sent, otherwise the saved preset preset_id, otherwise the workspace's default preset, otherwise CutPro's default. With prompt, the text follows that request instead of the style, rewriting current_text when given.

Charged in credits by the size of the material, usually 0 or 1; credits_charged says how much. 422 CAPTION_NO_CONTEXT when there is nothing to write from: a clip without speech, no images and no title or instructions.

Authorization

apiKey
headerX-Api-Key<token>

Request Body

  1. body
edit_id?string

Edit of the clip being posted; its speech is the main material

Length1 <= length <= 64
image_ids?array<>

Images of a photo post

Itemsitems <= 10
title?string

What the post is about, when there is no clip or as extra context

Lengthlength <= 5000
platforms*array<>

Networks the text is for, e.g. tiktok, youtube

Itemsitems <= 16
style?
preset_id?string

A preset from GET /posts/description/presets

Lengthlength <= 64
prompt?string

What to write, in your own words

Lengthlength <= 1000
current_text?string

Text to rewrite with prompt

Lengthlength <= 5000

Response Body

Response for status 200

application/json
  1. response
text*string

The description as one text, for networks that take a single caption

fields*

Per network, each field of its metadata in POST /posts with its text

credits_charged*number
POST
/posts/description
Example Request
curl -X POST 'https://api.cut.pro/api/v1/posts/description' \  -H 'Content-Type: application/json' \  -d '{  "platforms": [    "string"  ]}'
Example Response
{  "text": "string",  "fields": {    "property1": {      "property1": "string",      "property2": "string"    },    "property2": {      "property1": "string",      "property2": "string"    }  },  "credits_charged": 0}