faceless-cli 1.0.0 → 1.1.6

package/package.json

@@ -1,37 +1,37 @@
 {
-  "name": "faceless-cli",
-  "version": "1.0.0",
-  "description": "CLI for Faceless.so: create AI faceless videos, run automated series and publish to YouTube, TikTok, Instagram and more.",
-  "type": "module",
-  "bin": {
-    "faceless": "bin/faceless.js",
-    "fcl": "bin/faceless.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "license": "MIT",
-  "homepage": "https://faceless.so",
-  "keywords": [
-    "faceless",
-    "cli",
-    "mcp",
-    "ai",
-    "video",
-    "faceless-video",
-    "youtube",
-    "tiktok",
-    "social-media",
-    "scheduling"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "commander": "^13.0.0"
-  }
+	"name": "faceless-cli",
+	"version": "1.1.6",
+	"description": "CLI for Faceless.so: create AI faceless videos, run automated series and publish to YouTube, TikTok, Instagram and more.",
+	"type": "module",
+	"bin": {
+		"faceless": "bin/faceless.js",
+		"fcl": "bin/faceless.js"
+	},
+	"files": [
+		"bin",
+		"src",
+		"README.md",
+		"LICENSE"
+	],
+	"engines": {
+		"node": ">=18"
+	},
+	"license": "MIT",
+	"homepage": "https://faceless.so",
+	"keywords": [
+		"faceless",
+		"cli",
+		"mcp",
+		"ai",
+		"video",
+		"faceless-video",
+		"youtube",
+		"tiktok",
+		"social-media",
+		"scheduling"
+	],
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.29.0",
+		"commander": "^13.0.0"
+	}
 }

package/src/generated/operations.json

@@ -1,6 +1,6 @@
 {
   "generatedFrom": "src/backend/api/v1/spec/registry.mjs",
-  "version": "1.0.0",
+  "version": "1.1.6",
   "baseUrl": "https://faceless.so/api/v1",
   "operations": [
     {
@@ -317,7 +317,7 @@
             "name": "Ocean facts",
             "platform": "tts",
             "model": "storyboard",
-            "renderedVideoUrl": null,
+            "renderedVideoUrl": "https://exports.faceless.so/renders/665f1b2a9c31a2b3c4d5e801/1730000000000.mp4",
             "createdAt": "2026-07-30T10:00:00.000Z"
           }
         ],
@@ -363,6 +363,24 @@
           "voiceId": "EXAVITQu4vr4xnSDxMaL",
           "status": "completed",
           "renderedVideoUrl": "https://exports.faceless.so/renders/665f1b2a9c31a2b3c4d5e801/1722333444555.mp4",
+          "thumbnailUrl": "https://exports.faceless.so/thumbnails/665f1b2a9c31a2b3c4d5e801/1/a1b2c3d4.jpg",
+          "thumbnails": {
+            "status": "ready",
+            "generation": 1,
+            "aspect": "9:16",
+            "selectedVariantId": "a1b2c3d4-0000-4000-8000-000000000001",
+            "selectedBy": "ai",
+            "variants": [
+              {
+                "id": "a1b2c3d4-0000-4000-8000-000000000001",
+                "url": "https://exports.faceless.so/thumbnails/665f1b2a9c31a2b3c4d5e801/1/a1b2c3d4.jpg",
+                "hookText": "OCEAN RIVERS",
+                "source": "ai",
+                "score": 88,
+                "grade": "S"
+              }
+            ]
+          },
           "createdAt": "2026-07-30T10:00:00.000Z"
         }
       }
@@ -535,6 +553,69 @@
           "name": "Ocean facts",
           "youtubePost": {
             "title": "The ocean has rivers underwater"
+          },
+          "thumbnailUrl": "https://exports.faceless.so/thumbnails/665f1b2a9c31a2b3c4d5e801/1/a1b2c3d4.jpg",
+          "thumbnails": {
+            "status": "ready",
+            "selectedBy": "ai",
+            "variants": [
+              "https://exports.faceless.so/thumbnails/665f1b2a9c31a2b3c4d5e801/a.jpg"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "operationId": "selectVideoThumbnail",
+      "method": "post",
+      "path": "/videos/{id}/thumbnail",
+      "resource": "videos",
+      "summary": "Choose which thumbnail a video uses",
+      "description": "Selects one of the video's thumbnail variants as the effective thumbnail. Read the available variants from GET /videos/{id} (the thumbnails object). The choice is marked as a user pick, so later automatic regenerations will not overwrite it, and it is what gets pushed to YouTube and used as the Instagram Reels cover at post time. Thumbnails are free and generated automatically after a video completes.",
+      "scopes": [
+        "videos:write"
+      ],
+      "status": 200,
+      "idempotent": false,
+      "terminalStates": null,
+      "creditCost": "none",
+      "cli": {
+        "command": "videos select-thumbnail"
+      },
+      "mcp": {
+        "name": "faceless_select_video_thumbnail",
+        "enabled": true
+      },
+      "querySchema": null,
+      "requestSchema": {
+        "type": "object",
+        "properties": {
+          "variantId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Variant id from the thumbnails.variants array on GET /videos/{id}"
+          }
+        },
+        "required": [
+          "variantId"
+        ],
+        "additionalProperties": false
+      },
+      "requestExample": {
+        "variantId": "a1b2c3d4-0000-4000-8000-000000000002"
+      },
+      "responseExample": {
+        "success": true,
+        "data": {
+          "id": "665f1b2a9c31a2b3c4d5e801",
+          "thumbnailUrl": "https://exports.faceless.so/thumbnails/665f1b2a9c31a2b3c4d5e801/1/b2c3d4e5.jpg",
+          "thumbnails": {
+            "status": "ready",
+            "selectedVariantId": "a1b2c3d4-0000-4000-8000-000000000002",
+            "selectedBy": "user",
+            "variants": [
+              "https://exports.faceless.so/thumbnails/665f1b2a9c31a2b3c4d5e801/a.jpg"
+            ]
           }
         }
       }
@@ -573,8 +654,10 @@
           "status": "processing",
           "percentCompleted": 62,
           "readyForEditing": false,
-          "errorMessages": [],
-          "renderedVideoUrl": null
+          "errorMessages": [
+            "b-roll fetch timed out, retried"
+          ],
+          "renderedVideoUrl": "https://exports.faceless.so/renders/665f1b2a9c31a2b3c4d5e801/1730000000000.mp4"
         }
       }
     },
@@ -770,6 +853,22 @@
             },
             "description": "Connected account ids to auto-post to (from GET /accounts)"
           },
+          "generateThumbnails": {
+            "type": "boolean",
+            "description": "Generate 3 AI thumbnail variants for every episode and auto-select the best. Free. Defaults to true."
+          },
+          "thumbnailSettings": {
+            "type": "object",
+            "properties": {
+              "styleHint": {
+                "type": "string",
+                "maxLength": 200,
+                "description": "Free-text art direction for the thumbnail backgrounds, e.g. \"moody neon, close-up faces\""
+              }
+            },
+            "additionalProperties": false,
+            "description": "Thumbnail generation options. Ignored when generateThumbnails is false."
+          },
           "autoPostTime": {
             "type": "string",
             "description": "Daily auto-post time \"HH:mm\" in the series timezone"
@@ -1015,6 +1114,22 @@
             },
             "description": "Connected account ids to auto-post to (from GET /accounts)"
           },
+          "generateThumbnails": {
+            "type": "boolean",
+            "description": "Generate 3 AI thumbnail variants for every episode and auto-select the best. Free. Defaults to true."
+          },
+          "thumbnailSettings": {
+            "type": "object",
+            "properties": {
+              "styleHint": {
+                "type": "string",
+                "maxLength": 200,
+                "description": "Free-text art direction for the thumbnail backgrounds, e.g. \"moody neon, close-up faces\""
+              }
+            },
+            "additionalProperties": false,
+            "description": "Thumbnail generation options. Ignored when generateThumbnails is false."
+          },
           "autoPostTime": {
             "type": "string",
             "description": "Daily auto-post time \"HH:mm\" in the series timezone"
@@ -1528,8 +1643,20 @@
               "channelName": "Deep Sea Facts"
             }
           ],
-          "tiktok": [],
-          "instagram": []
+          "tiktok": [
+            {
+              "id": "665f1b2a9c31a2b3c4d5e901",
+              "username": "mychannel",
+              "status": "connected"
+            }
+          ],
+          "instagram": [
+            {
+              "id": "665f1b2a9c31a2b3c4d5e902",
+              "username": "mychannel",
+              "status": "connected"
+            }
+          ]
         }
       }
     },

package/src/index.mjs

@@ -435,6 +435,19 @@ videos
     print(result, { json: cmd.optsWithGlobals().json });
   });
 
+videos
+  .command("select-thumbnail <id>")
+  .description(getOp("selectVideoThumbnail").summary)
+  .requiredOption("--variant <variantId>", "variant id from the thumbnails.variants array on `faceless videos get <id>`")
+  .action(async (id, opts, cmd) => {
+    const result = await execute(
+      "selectVideoThumbnail",
+      { pathParams: { id }, body: { variantId: opts.variant } },
+      cmd
+    );
+    print(result, { json: cmd.optsWithGlobals().json });
+  });
+
 withWaitFlags(
   videos.command("status <id>").description(getOp("getVideoStatus").summary),
   "video"