Remix references

curl --request POST \
  --url https://api.sigmora.org/v1/video/remix \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "prj_9x2a4c",
  "sources": [
    {
      "type": "url",
      "url": "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
      "label": "Reference short"
    },
    {
      "type": "transcript",
      "content": "Stop budgeting by category. Budget by the day you get paid instead.",
      "label": "Competitor hook"
    }
  ],
  "instructions": "Combine both into one 45-second short for first-job earners in Nairobi.",
  "targetPlatform": "shorts",
  "suggestedDurationSeconds": 45
}
'

import requests

url = "https://api.sigmora.org/v1/video/remix"

payload = {
    "projectId": "prj_9x2a4c",
    "sources": [
        {
            "type": "url",
            "url": "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
            "label": "Reference short"
        },
        {
            "type": "transcript",
            "content": "Stop budgeting by category. Budget by the day you get paid instead.",
            "label": "Competitor hook"
        }
    ],
    "instructions": "Combine both into one 45-second short for first-job earners in Nairobi.",
    "targetPlatform": "shorts",
    "suggestedDurationSeconds": 45
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    projectId: 'prj_9x2a4c',
    sources: [
      {
        type: 'url',
        url: 'https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4',
        label: 'Reference short'
      },
      {
        type: 'transcript',
        content: 'Stop budgeting by category. Budget by the day you get paid instead.',
        label: 'Competitor hook'
      }
    ],
    instructions: 'Combine both into one 45-second short for first-job earners in Nairobi.',
    targetPlatform: 'shorts',
    suggestedDurationSeconds: 45
  })
};

fetch('https://api.sigmora.org/v1/video/remix', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "credits": 300,
  "remix": {},
  "projectId": "prj_9x2a4c",
  "creditBalance": 3900,
  "gate": {
    "decision": "pass",
    "reportId": "<string>",
    "hookVerified": true,
    "thesisVerified": true,
    "patchedScript": "<string>",
    "warning": "<string>"
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

Remix references

Synthesise one original script from up to ten reference videos or transcripts. Each source is reconstructed first — a URL is fetched and transcribed, a transcript is taken as given — and then ONE new script is written from all of them against your instructions. It is not a paraphrase of the best source. Priced by the work: from transcripts alone it is one script (script), or one scene plan (scene-plan) when outputFormat is scenes; with any url source it is one video analysis (video-analysis) per url source, each up to 180 seconds long.

POST

video

remix

Remix references

curl --request POST \
  --url https://api.sigmora.org/v1/video/remix \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "prj_9x2a4c",
  "sources": [
    {
      "type": "url",
      "url": "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
      "label": "Reference short"
    },
    {
      "type": "transcript",
      "content": "Stop budgeting by category. Budget by the day you get paid instead.",
      "label": "Competitor hook"
    }
  ],
  "instructions": "Combine both into one 45-second short for first-job earners in Nairobi.",
  "targetPlatform": "shorts",
  "suggestedDurationSeconds": 45
}
'

import requests

url = "https://api.sigmora.org/v1/video/remix"

payload = {
    "projectId": "prj_9x2a4c",
    "sources": [
        {
            "type": "url",
            "url": "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
            "label": "Reference short"
        },
        {
            "type": "transcript",
            "content": "Stop budgeting by category. Budget by the day you get paid instead.",
            "label": "Competitor hook"
        }
    ],
    "instructions": "Combine both into one 45-second short for first-job earners in Nairobi.",
    "targetPlatform": "shorts",
    "suggestedDurationSeconds": 45
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    projectId: 'prj_9x2a4c',
    sources: [
      {
        type: 'url',
        url: 'https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4',
        label: 'Reference short'
      },
      {
        type: 'transcript',
        content: 'Stop budgeting by category. Budget by the day you get paid instead.',
        label: 'Competitor hook'
      }
    ],
    instructions: 'Combine both into one 45-second short for first-job earners in Nairobi.',
    targetPlatform: 'shorts',
    suggestedDurationSeconds: 45
  })
};

fetch('https://api.sigmora.org/v1/video/remix', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "credits": 300,
  "remix": {},
  "projectId": "prj_9x2a4c",
  "creditBalance": 3900,
  "gate": {
    "decision": "pass",
    "reportId": "<string>",
    "hookVerified": true,
    "thesisVerified": true,
    "patchedScript": "<string>",
    "warning": "<string>"
  }
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "success": false,
  "error": "<string>",
  "code": "invalid_request",
  "details": "<unknown>",
  "requestId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

A workspace API key.

Headers

idempotency-key

string

Stable retry key for this logical paid call. Reuse it after a timeout to receive the original result without duplicate work or spend.

Required string length: 1 - 255

x-sigmora-quote-only

string

Send 1 to get the price, balance and budget verdict without running anything.

Allowed value: "1"

x-sigmora-max-credits

string

The approved price; a call that would cost more is refused and nothing is charged.

Pattern: ^\d+$

Body

application/json

sources

object[]

required

One to ten references. url is fetched and transcribed for you; transcript is used as sent.

Required array length: 1 - 10 elements

Option 1
Option 2

Show child attributes

instructions

string

required

What the new script should do differently.

Required string length: 1 - 4000

projectId

string

required

The existing project to file this work under. Create it with POST /v1/projects, then reuse its id across related calls. A project this workspace does not own answers not_found; the work is never silently filed somewhere else.

Required string length: 1 - 200

language

string

Output language. Defaults to English.

Required string length: 1 - 60

outputFormat

enum<string>

Return one continuous script or a scene-by-scene structure. Defaults to script.

Available options:

script,

scenes

targetPlatform

enum<string>

Platform conventions to write for. general is platform-neutral and is the default.

Available options:

tiktok,

reels,

shorts,

youtube,

twitter,

general

niche

string

Subject area for terminology and framing.

Maximum string length: 200

brandContext

string

Anything the writer should know about your brand: voice, claims, things to avoid. It shapes the new script; it is never treated as source material.

Maximum string length: 4000

verify

boolean

Fact-check the finished script against public sources before it is returned. A script whose hook or thesis cannot be verified is withheld and nothing is charged. Without web search configured the script is returned unchecked, with a warning in gate.

suggestedDurationSeconds

integer

Target runtime for the resulting script, in seconds. 5 to 3,600.

Required range: 5 <= x <= 3600

Response

Success.

Option 1
Option 2

success

boolean

required

credits

number

required

What this call actually cost, which is not always what was quoted.

Example:

300

remix

object

required

The synthesised script, or scenes when outputFormat asked for them.

Show child attributes

projectId

string

The existing project this work was filed under. It matches the projectId supplied by the caller after workspace ownership was verified.

Example:

"prj_9x2a4c"

creditBalance

number

Your balance after the charge. Absent when billing is disabled for the workspace.

Example:

3900

gate

object

Present when verify was sent. A script the check did not clear is never returned (and never charged).

Show child attributes

{key}

any

Meta

Projects

Sessions

Assets

Jobs

Text

Video

UGC

Editing

3D

Image

Audio

Publishing

Webhooks

Workflows

Agents

Research

Themes

Signals

Discovery

Watchlist

Performance

Autopilot

Campaigns

Brands

Products

Remix references

Authorizations

Headers

Body

Response