Use case

Post a different version on every account

Works on: Any network: versions are 1080x1920 MP4s you post with POST /v1/posts

Run several accounts without posting the same file twice: turn one video into up to 20 versions. See the Variations guide.

  1. 1

    Upload the finished video (or skip this and pass a TikTok, Reels, YouTube or X link).

    curl -X POST "https://creatoros-production-5658.up.railway.app/v1/media" \
      -H "Authorization: Bearer $CREATOROS_API_KEY" \
      -H "Content-Type: video/mp4" \
      -H "X-Filename: clip.mp4" \
      --data-binary @clip.mp4
  2. 2

    Make the versions. Each gets its own grade, zoom, hook, GIF b-roll, length, sound bed and caption.

    curl -X POST "https://creatoros-production-5658.up.railway.app/v1/variations" \
      -H "Authorization: Bearer $CREATOROS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "video_url": "med_b0Wq7Yx2Rk9LzT4nVs1Pc8Hf3Jd6Gm5Ea2Uo7Ki9Nr0",
        "count": 20,
        "hook_mode": "auto",
        "notes": "Free guide, link in bio"
      }'
  3. 3

    Poll the run until status is done. Each entry in renders has its video_url, hook, caption and hashtags.

    GET/v1/variations/{jobId}Get a run reference →
    curl "https://creatoros-production-5658.up.railway.app/v1/variations/7f3a1c2e-5b8d-4e9f-a1c3-2d4e6f8a0b1c" \
      -H "Authorization: Bearer $CREATOROS_API_KEY"
  4. 4

    Post each version to its own account with its own caption.

    curl -X POST "https://creatoros-production-5658.up.railway.app/v1/posts" \
      -H "Authorization: Bearer $CREATOROS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "content": "You do not need new content every day. #contentcreation",
        "platforms": [
          "tiktok"
        ],
        "account_ids": [
          "acc_..."
        ],
        "post_type": "short_video",
        "media": [
          "https://api.creatoros.ca/v1/media/med_..."
        ]
      }'

Unlimited on paid plans; one run during a free trial. Nothing is posted until you post it.

With the CLI

$ creatoros variations:create video.mp4 --count 20 --waitCopy
$ creatoros variations:download <id>Copy

Or ask your agent

“Make 20 variations of this video, then post version 1 to my main TikTok and version 2 to my second TikTok, each with its own caption.”