diff --git a/sdk.mdx b/cli.mdx similarity index 58% rename from sdk.mdx rename to cli.mdx index 6974631..29394ea 100644 --- a/sdk.mdx +++ b/cli.mdx @@ -107,3 +107,76 @@ 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 | + +## 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 + +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 +``` + +| Flag | Required | Description | +|------|----------|-------------| +| `--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 +``` + +| Flag | Required | Description | +|------|----------|-------------| +| `--artist ` | Yes | Artist account ID | +| `--template ` | No | Template name (default: random) | +| `--lipsync` | No | Enable lipsync mode | +| `--upscale` | No | Enable upscaling | + +### Create content + +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 +recoup content create --artist --template --lipsync --upscale +recoup content create --artist --json +``` + +| Flag | Required | Description | +|------|----------|-------------| +| `--artist ` | Yes | Artist account ID | +| `--template ` | No | Template name (default: random) | +| `--lipsync` | No | Enable lipsync mode | +| `--upscale` | No | Enable upscaling | +| `--caption-length ` | No | Max caption length in characters | 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" ] }