Stories

Create a Story

Create a Story draft from a publicly accessible media URL. Charges against the image or video generation quota (one upload = one charge). Use POST /v1/stories/{storyId}/publish or /schedule to actually post it.

post/v1/stories

Request

  • Base URL: https://www.postquick.ai/api
  • URL: https://www.postquick.ai/api/v1/stories
  • Auth: HTTP bearer

Request body

contentGroupIdstring required

Content group to create the story in.

storyType'image' | 'video' required

Story media type

mediaUrlstring uri required

Publicly accessible URL of the story media. Graph API and TikTok pull from this URL during publishing.

thumbnailUrlstring uri

Optional thumbnail for video stories.

captionstring
platformsstring[]

Target platforms. Can also be set later via publish/schedule.

durationinteger

Video duration in seconds. Stories must be ≤60s.

mediaFit'contain' | 'cover' | 'fill'

How non-9:16 media is fitted into the 1080x1920 story frame: contain (letterbox with black bars, default), cover (crop to fill), or fill (stretch).

Response

Story draft created.

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.