API resource

Agent Edits

Send a talking-head clip and get it back edited in the Creator OS house style by an editing agent on our servers:short is a 9:16 split-screen edit (animations, real logos, GIFs and number beats on top, your face in a rounded band below, kinetic captions, sound design), long is a 16:9 YouTube hyper edit (hero animation slot, picture-in-picture head, flow diagrams, phrase captions). Edits run in the background: a short takes about 15 to 30 minutes. Poll the edit, then post output_url. Upload the clip first with POST /v1/media.

Start an edit

POST/v1/agent-edits

Queues the edit. Up to 3 in progress at once and a monthly allowance (see monthly on the list).

Body

video_urlstringrequired

The talking-head clip: an https URL or a med_ id from POST /v1/media.

format"short" | "long"required

short: 9:16, clips up to 3 minutes. long: 16:9.

titlestring

What the video is about.

notesstring

Product names to spell right, logos to show, what to emphasize.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/agent-edits" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "med_b0Wq7Yx2Rk9LzT4nVs1Pc8Hf3Jd6Gm5Ea2Uo7Ki9Nr0",
    "format": "short",
    "title": "Our new AI receptionist",
    "notes": "Show the Acme logo on \"Acme\"."
  }'

Response 201

{
  "edit": {
    "id": "4d1c8e2a-7b3f-4e6a-9c2d-1a5b8f3e6c90",
    "format": "short",
    "style": "split-animated-talking-head",
    "status": "queued",
    "step": null,
    "output_url": null
  }
}

Get an edit

GET/v1/agent-edits/{editId}

status: queued, working, done, failed or cancelled. log is the editor's progress; output_url (MP4) and cover_url appear when it's done.

Path parameters

editIdstringrequired

The edit id.

curl "https://creatoros-production-5658.up.railway.app/v1/agent-edits/4d1c8e2a-7b3f-4e6a-9c2d-1a5b8f3e6c90" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "edit": {
    "id": "4d1c8e2a-7b3f-4e6a-9c2d-1a5b8f3e6c90",
    "status": "done",
    "output_url": "https://media.example.com/final.mp4",
    "cover_url": "https://media.example.com/cover.jpg",
    "duration_s": 39.2,
    "log": [
      {
        "at": "2026-11-01T18:20:00Z",
        "text": "Sourcing the brand marks"
      }
    ]
  }
}

List edits

GET/v1/agent-edits

Newest first, with this month's allowance.

curl "https://creatoros-production-5658.up.railway.app/v1/agent-edits" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "edits": [
    {
      "id": "4d1c8e2a-7b3f-4e6a-9c2d-1a5b8f3e6c90",
      "format": "short",
      "status": "working",
      "step": "Rendering frames"
    }
  ],
  "monthly": {
    "used": 4,
    "limit": 30
  }
}

Cancel an edit

POST/v1/agent-edits/{editId}/cancel

Stops a queued or running edit. Delete one with DELETE /v1/agent-edits/{editId}.

Path parameters

editIdstringrequired

The edit id.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/agent-edits/4d1c8e2a-7b3f-4e6a-9c2d-1a5b8f3e6c90/cancel" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "ok": true
}

PreviousReverse engineer marketing NextEditing styles and AI tool keys