From 443dca42f1c60b9e6f2d41971154db28d337e83a Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Thu, 12 Mar 2026 18:57:19 -0500 Subject: [PATCH 1/6] docs: add CLI content command documentation Documents the new recoup content command suite: templates, validate, estimate, create, and status subcommands with flags and examples. Co-Authored-By: Claude Opus 4.6 --- sdk.mdx | 75 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) diff --git a/sdk.mdx b/sdk.mdx index 6974631..2a26e25 100644 --- a/sdk.mdx +++ b/sdk.mdx @@ -97,6 +97,81 @@ recoup chats create --name "My Topic" --artist recoup chats list --json ``` +## content + +Content-creation pipeline commands. Generate AI-powered social videos for artists. + +### List templates + +List available content templates. See [`GET /api/content/templates`](/api-reference/content/templates). + +```bash +recoup content templates +recoup content templates --json +``` + +### Validate artist readiness + +Check whether an artist has the required files (face-guide, songs, context) for content creation. See [`GET /api/content/validate`](/api-reference/content/validate). + +```bash +recoup content validate --artist +recoup content validate --artist --json +``` + +| Flag | Required | Description | +|------|----------|-------------| +| `--artist ` | Yes | Artist account ID | + +### Estimate cost + +Estimate the cost of a content creation run. See [`GET /api/content/estimate`](/api-reference/content/estimate). + +```bash +recoup content estimate +recoup content estimate --lipsync --batch 3 +recoup content estimate --json +``` + +| Flag | Required | Description | +|------|----------|-------------| +| `--lipsync` | No | Enable lip-sync mode | +| `--batch ` | No | Number of videos (default: 1) | +| `--compare` | No | Compare lipsync vs non-lipsync costs | + +### Create content + +Trigger a content creation run. See [`POST /api/content/create`](/api-reference/content/create). + +```bash +recoup content create --artist +recoup content create --artist --template artist-caption-outside +recoup content create --artist --caption-length long --upscale --batch 3 +recoup content create --artist --json +``` + +| Flag | Required | Description | +|------|----------|-------------| +| `--artist ` | Yes | Artist account ID | +| `--template ` | No | Template name (default: `artist-caption-bedroom`) | +| `--lipsync` | No | Enable lip-sync mode | +| `--caption-length ` | No | `short`, `medium`, or `long` (default: `short`) | +| `--upscale` | No | Upscale image and video | +| `--batch ` | No | Number of videos (default: 1) | + +### Check run status + +Check the status of a content creation run. See [`GET /api/tasks/runs`](/api-reference/tasks/runs). + +```bash +recoup content status --run +recoup content status --run --json +``` + +| Flag | Required | Description | +|------|----------|-------------| +| `--run ` | Yes | Trigger.dev run ID | + ## sandboxes Manage sandboxes. See [`GET /api/sandboxes`](/api-reference/sandboxes/list) and [`POST /api/sandboxes`](/api-reference/sandboxes/create). From 3cc566e0cd9b863175421ce73a2cee932e5cdab6 Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Thu, 12 Mar 2026 19:00:55 -0500 Subject: [PATCH 2/6] docs: move run status to recoup tasks, remove from content Run status is a general tasks concept, not content-specific. Co-Authored-By: Claude Opus 4.6 --- sdk.mdx | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/sdk.mdx b/sdk.mdx index 2a26e25..d4391cb 100644 --- a/sdk.mdx +++ b/sdk.mdx @@ -159,19 +159,6 @@ recoup content create --artist --json | `--upscale` | No | Upscale image and video | | `--batch ` | No | Number of videos (default: 1) | -### Check run status - -Check the status of a content creation run. See [`GET /api/tasks/runs`](/api-reference/tasks/runs). - -```bash -recoup content status --run -recoup content status --run --json -``` - -| Flag | Required | Description | -|------|----------|-------------| -| `--run ` | Yes | Trigger.dev run ID | - ## sandboxes Manage sandboxes. See [`GET /api/sandboxes`](/api-reference/sandboxes/list) and [`POST /api/sandboxes`](/api-reference/sandboxes/create). @@ -182,3 +169,16 @@ recoup sandboxes create recoup sandboxes create --command "ls -la" recoup sandboxes list --json ``` + +## tasks + +Check the status of background task runs. See [`GET /api/tasks/runs`](/api-reference/tasks/runs). + +```bash +recoup tasks status --run +recoup tasks status --run --json +``` + +| Flag | Required | Description | +|------|----------|-------------| +| `--run ` | Yes | Trigger.dev run ID | From 96a723cb03c2c1cd58d264ddbcd9eb8002e1da53 Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Thu, 12 Mar 2026 19:05:02 -0500 Subject: [PATCH 3/6] feat: rename SDK page to CLI, add content commands after tasks section MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Rename sdk.mdx → cli.mdx with /cli route - Update docs.json navigation reference - Re-add content section (templates, validate, estimate, create) after tasks Co-Authored-By: Claude Opus 4.6 --- sdk.mdx => cli.mdx | 94 +++++++++++++++++++++++----------------------- docs.json | 2 +- 2 files changed, 48 insertions(+), 48 deletions(-) rename sdk.mdx => cli.mdx (72%) diff --git a/sdk.mdx b/cli.mdx similarity index 72% rename from sdk.mdx rename to cli.mdx index d4391cb..c49e3ba 100644 --- a/sdk.mdx +++ b/cli.mdx @@ -97,88 +97,88 @@ recoup chats create --name "My Topic" --artist recoup chats list --json ``` -## content - -Content-creation pipeline commands. Generate AI-powered social videos for artists. - -### List templates +## sandboxes -List available content templates. See [`GET /api/content/templates`](/api-reference/content/templates). +Manage sandboxes. See [`GET /api/sandboxes`](/api-reference/sandboxes/list) and [`POST /api/sandboxes`](/api-reference/sandboxes/create). ```bash -recoup content templates -recoup content templates --json +recoup sandboxes list +recoup sandboxes create +recoup sandboxes create --command "ls -la" +recoup sandboxes list --json ``` -### Validate artist readiness +## tasks -Check whether an artist has the required files (face-guide, songs, context) for content creation. See [`GET /api/content/validate`](/api-reference/content/validate). +Check the status of background task runs. See [`GET /api/tasks/runs`](/api-reference/tasks/runs). ```bash -recoup content validate --artist -recoup content validate --artist --json +recoup tasks status --run +recoup tasks status --run --json ``` | Flag | Required | Description | |------|----------|-------------| -| `--artist ` | Yes | Artist account ID | +| `--run ` | Yes | Trigger.dev run ID | -### Estimate cost +## content + +Content-creation pipeline commands. Generate AI-powered social videos for artists. + +### List templates -Estimate the cost of a content creation run. See [`GET /api/content/estimate`](/api-reference/content/estimate). +List available content templates. ```bash -recoup content estimate -recoup content estimate --lipsync --batch 3 -recoup content estimate --json +recoup content templates +recoup content templates --json ``` -| Flag | Required | Description | -|------|----------|-------------| -| `--lipsync` | No | Enable lip-sync mode | -| `--batch ` | No | Number of videos (default: 1) | -| `--compare` | No | Compare lipsync vs non-lipsync costs | - -### Create content +### Validate artist -Trigger a content creation run. See [`POST /api/content/create`](/api-reference/content/create). +Check that an artist has the required assets (face-guide, songs, context files) before creating content. ```bash -recoup content create --artist -recoup content create --artist --template artist-caption-outside -recoup content create --artist --caption-length long --upscale --batch 3 -recoup content create --artist --json +recoup content validate --artist +recoup content validate --artist --json ``` | Flag | Required | Description | |------|----------|-------------| -| `--artist ` | Yes | Artist account ID | -| `--template ` | No | Template name (default: `artist-caption-bedroom`) | -| `--lipsync` | No | Enable lip-sync mode | -| `--caption-length ` | No | `short`, `medium`, or `long` (default: `short`) | -| `--upscale` | No | Upscale image and video | -| `--batch ` | No | Number of videos (default: 1) | +| `--artist ` | Yes | Artist slug | -## sandboxes +### Estimate cost -Manage sandboxes. See [`GET /api/sandboxes`](/api-reference/sandboxes/list) and [`POST /api/sandboxes`](/api-reference/sandboxes/create). +Preview the estimated cost and duration for a content run without starting it. ```bash -recoup sandboxes list -recoup sandboxes create -recoup sandboxes create --command "ls -la" -recoup sandboxes list --json +recoup content estimate --artist +recoup content estimate --artist --template --json ``` -## tasks +| Flag | Required | Description | +|------|----------|-------------| +| `--artist ` | Yes | Artist slug | +| `--template ` | No | Template name (default: random) | +| `--lipsync` | No | Enable lipsync mode | +| `--upscale` | No | Enable upscaling | -Check the status of background task runs. See [`GET /api/tasks/runs`](/api-reference/tasks/runs). +### Create content + +Trigger the full content-creation pipeline. Returns a run ID you can check with `recoup tasks status`. ```bash -recoup tasks status --run -recoup tasks status --run --json +recoup content create --artist +recoup content create --artist --template --lipsync --upscale +recoup content create --artist --json ``` | Flag | Required | Description | |------|----------|-------------| -| `--run ` | Yes | Trigger.dev run ID | +| `--artist ` | Yes | Artist slug | +| `--template ` | No | Template name (default: random) | +| `--lipsync` | No | Enable lipsync mode | +| `--upscale` | No | Enable upscaling | +| `--caption-length ` | No | Max caption length in characters | + +This command wraps [`POST /api/content`](/api-reference/content/create). diff --git a/docs.json b/docs.json index 440cc2e..3aa26de 100644 --- a/docs.json +++ b/docs.json @@ -19,7 +19,7 @@ "index", "quickstart", "mcp", - "sdk", + "cli", "api-reference/sandboxes/create" ] } From bd66a51744e73fe65031e96bf2ff8027dfb30fc6 Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Thu, 12 Mar 2026 19:05:51 -0500 Subject: [PATCH 4/6] feat: add API reference links to content CLI commands Co-Authored-By: Claude Opus 4.6 --- cli.mdx | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/cli.mdx b/cli.mdx index c49e3ba..42b0d19 100644 --- a/cli.mdx +++ b/cli.mdx @@ -127,7 +127,7 @@ Content-creation pipeline commands. Generate AI-powered social videos for artist ### List templates -List available content templates. +List available content templates. See [`GET /api/content/templates`](/api-reference/content/templates). ```bash recoup content templates @@ -136,7 +136,7 @@ recoup content templates --json ### Validate artist -Check that an artist has the required assets (face-guide, songs, context files) before creating content. +Check that an artist has the required assets (face-guide, songs, context files) before creating content. See [`POST /api/content/validate`](/api-reference/content/validate). ```bash recoup content validate --artist @@ -149,7 +149,7 @@ recoup content validate --artist --json ### Estimate cost -Preview the estimated cost and duration for a content run without starting it. +Preview the estimated cost and duration for a content run without starting it. See [`POST /api/content/estimate`](/api-reference/content/estimate). ```bash recoup content estimate --artist @@ -165,7 +165,7 @@ recoup content estimate --artist --template --json ### Create content -Trigger the full content-creation pipeline. Returns a run ID you can check with `recoup tasks status`. +Trigger the full content-creation pipeline. Returns a run ID you can check with `recoup tasks status`. See [`POST /api/content`](/api-reference/content/create). ```bash recoup content create --artist @@ -180,5 +180,3 @@ recoup content create --artist --json | `--lipsync` | No | Enable lipsync mode | | `--upscale` | No | Enable upscaling | | `--caption-length ` | No | Max caption length in characters | - -This command wraps [`POST /api/content`](/api-reference/content/create). From 4c2b9fddee260f0b4e64fe92d026ab069233170f Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Thu, 12 Mar 2026 19:06:39 -0500 Subject: [PATCH 5/6] fix: use artist_account_id instead of artistSlug in content CLI docs Aligns CLI docs with the API reference which uses artist_account_id. Co-Authored-By: Claude Opus 4.6 --- cli.mdx | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/cli.mdx b/cli.mdx index 42b0d19..1a552ee 100644 --- a/cli.mdx +++ b/cli.mdx @@ -139,26 +139,26 @@ recoup content templates --json Check that an artist has the required assets (face-guide, songs, context files) before creating content. See [`POST /api/content/validate`](/api-reference/content/validate). ```bash -recoup content validate --artist -recoup content validate --artist --json +recoup content validate --artist +recoup content validate --artist --json ``` | Flag | Required | Description | |------|----------|-------------| -| `--artist ` | Yes | Artist slug | +| `--artist ` | Yes | Artist account ID | ### Estimate cost Preview the estimated cost and duration for a content run without starting it. See [`POST /api/content/estimate`](/api-reference/content/estimate). ```bash -recoup content estimate --artist -recoup content estimate --artist --template --json +recoup content estimate --artist +recoup content estimate --artist --template --json ``` | Flag | Required | Description | |------|----------|-------------| -| `--artist ` | Yes | Artist slug | +| `--artist ` | Yes | Artist account ID | | `--template ` | No | Template name (default: random) | | `--lipsync` | No | Enable lipsync mode | | `--upscale` | No | Enable upscaling | @@ -168,14 +168,14 @@ recoup content estimate --artist --template --json Trigger the full content-creation pipeline. Returns a run ID you can check with `recoup tasks status`. See [`POST /api/content`](/api-reference/content/create). ```bash -recoup content create --artist -recoup content create --artist --template --lipsync --upscale -recoup content create --artist --json +recoup content create --artist +recoup content create --artist --template --lipsync --upscale +recoup content create --artist --json ``` | Flag | Required | Description | |------|----------|-------------| -| `--artist ` | Yes | Artist slug | +| `--artist ` | Yes | Artist account ID | | `--template ` | No | Template name (default: random) | | `--lipsync` | No | Enable lipsync mode | | `--upscale` | No | Enable upscaling | From 2010b7056ab6a5dffa02a66339a0d016c38d7eb3 Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Thu, 12 Mar 2026 19:07:34 -0500 Subject: [PATCH 6/6] fix: link 'recoup tasks status' to tasks section in create content docs Co-Authored-By: Claude Opus 4.6 --- cli.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cli.mdx b/cli.mdx index 1a552ee..29394ea 100644 --- a/cli.mdx +++ b/cli.mdx @@ -165,7 +165,7 @@ recoup content estimate --artist --template --json ### Create content -Trigger the full content-creation pipeline. Returns a run ID you can check with `recoup tasks status`. See [`POST /api/content`](/api-reference/content/create). +Trigger the full content-creation pipeline. Returns a run ID you can check with [`recoup tasks status`](/cli#tasks). See [`POST /api/content`](/api-reference/content/create). ```bash recoup content create --artist