Creator OSDocs

API resource

Editing styles and AI tool keys

Editing styles are Creator OS's video production templates (split talking head, AI avatar videos, fast-cut faceless shorts, music edits, long-form edits, animated explainers). Reverse engineer marketing assigns one to every video it plans (editing_styleon formats and calendar items) and lists what it needs from you in the run'srequests. Some styles use your own AI tools: HeyGen for avatars, Fish Audio or ElevenLabs for voiceovers in your voice. Keys are checked live, stored encrypted per workspace and never returned (last 4 characters only).

List editing styles

GET/v1/editing-styles

Every style with its aspect ratio, what it needs (inputs: own_footage, voiceover, avatar, song, reference_video, script) and the key groups it requires; motion_looks, the animated-explainer looks of motion-styles (74 built: whiteboard, chalkboard, claymation, CRT terminal, manga, synthwave and more; a plan sets motion_look on videos that use them); and this workspace's key status.

curl "https://creatoros-production-5658.up.railway.app/v1/editing-styles" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "styles": [
    {
      "slug": "split-animated-short",
      "name": "Split animated short (AI avatar)",
      "aspect": "9:16",
      "inputs": [
        "avatar",
        "script"
      ],
      "keys": [
        [
          "heygen"
        ]
      ],
      "plannable": true
    }
  ],
  "motion_looks": [
    {
      "id": "whiteboard",
      "name": "Whiteboard Explainer",
      "family": "Hand-Drawn",
      "look": "...",
      "built": true
    }
  ],
  "providers": [
    {
      "provider": "heygen",
      "name": "HeyGen",
      "connected": false,
      "last4": null,
      "get_key_url": "https://app.heygen.com/settings?nav=API"
    }
  ]
}

AI tool key status

GET/v1/provider-keys

heygen, fish_audio and elevenlabs: connected or not, last 4 characters, where to get a key.

curl "https://creatoros-production-5658.up.railway.app/v1/provider-keys" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "providers": [
    {
      "provider": "fish_audio",
      "name": "Fish Audio",
      "connected": true,
      "last4": "a1b2"
    }
  ]
}

Add an AI tool key

PUT/v1/provider-keys/{provider}

Checked live with the provider before it's saved; 400 key_rejected if it doesn't work.

Path parameters

providerstringrequired

heygen, fish_audio or elevenlabs.

Body

keystringrequired

The API key.

curl -X PUT "https://creatoros-production-5658.up.railway.app/v1/provider-keys/heygen" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "your-heygen-key"
  }'
Response 200
{
  "provider": {
    "provider": "heygen",
    "connected": true,
    "last4": "9xQ2"
  },
  "checked": true
}

Remove an AI tool key

DELETE/v1/provider-keys/{provider}

Deletes the stored key. Styles that need it show up again in a run's requests.

Path parameters

providerstringrequired

heygen, fish_audio or elevenlabs.

curl -X DELETE "https://creatoros-production-5658.up.railway.app/v1/provider-keys/heygen" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "ok": true
}
PreviousAgent EditsNextAgent skills