@pippit-dev/cli 1.0.1 → 1.0.3

package/README.md

@@ -196,7 +196,7 @@ npx @pippit-dev/cli@latest install
 export XYQ_ACCESS_KEY="<access-key>"
 pippit-tool-cli --version
 pippit-tool-cli short-drama +submit-run --message "写一个赛博朋克短剧开头"
-pippit-tool-cli upload-file --path ./reference.doc
+pippit-tool-cli short-drama +upload-file --path ./reference.doc
 pippit-tool-cli get-thread --thread-id thread_123 --run-id run_456
 pippit-tool-cli list-thread-file --thread-id thread_123 --page-num 1 --page-size 200
 pippit-tool-cli download-result --output-path ./thread_123/results/result.mp4 --url URL --updated-at 1779716734
@@ -205,15 +205,45 @@ pippit-tool-cli download-result --output-path ./thread_123/results/result.mp4 --
 `+submit-run`: 输出 `thread_id`、`run_id` 和 `web_thread_link`；其中 `--message` 为必填参数。
 `get-thread`: 请求中带 `version=v2`，并输出 `readable_text`。
 `list-thread-file`: 输出会话文件列表、分页提示和可直接传给下载命令的 `file_path`。
-`upload-file`: 输出返回的 `asset_id`。 当前仅支持 `.doc`、`.docx` 和 `.txt` 文件。
+`+upload-file`: 输出返回的 `asset_id`。 当前仅支持 `.doc`、`.docx` 和 `.txt` 文件。
 `download-result`: 会把结果 URL 下载到 `--output-path` 指定的文件路径；传入 `--updated-at` 后，如果本地文件早于该时间戳会覆盖更新，否则跳过。
 
 短剧命令的错误日志会追加写入本地每日日志文件：`~/.pippit_tool_cli/logs/yyyy-mm-dd.log`。日志路径会基于当前用户主目录和系统路径分隔符生成，因此可在 macOS、Linux 和 Windows 上使用。
 
+## 生视频 CLI
+
+`generate-video` 会上传本地参考图片和视频，然后向视频片段 Agent 提交生视频请求：
+
+```bash
+pippit-tool-cli generate-video \
+  --prompt "做个小猫视频" \
+  --image "~/images/cat1.jpg" \
+  --image "~/images/cat2.jpg" \
+  --video "~/images/video1.mp4" \
+  --video "~/images/video2.mp4" \
+  --duration 5 \
+  --ratio "9:16" \
+  --model "seedance2.0_direct" \
+  --resolution "720p"
+```
+
+命令输出 `thread_id`、`run_id` 和 `web_thread_link`。提交生视频 HTTP 请求时，参考图和参考视频会使用上传接口返回的 `pippit_asset_id`。图片最多 9 张，支持 `.jpg`、`.jpeg`、`.png`、`.gif`、`.bmp`、`.webp`、`.svg`；视频最多 3 个，支持 `.mp4`、`.avi`、`.mov`、`.wmv`、`.flv`、`.webm`、`.mkv`、`.m4v`。普通用户支持模型 `seedance2.0_direct` 和 `seedance2.0_fast_direct`；VIP 用户额外支持 `seedance2.0_vision` 和 `seedance2.0_fast_vision`。模型、比例、分辨率、素材数量等参数的语义校验当前预留在后续实现。
+
+查询并下载生视频结果：
+
+```bash
+pippit-tool-cli query-result \
+  --thread-id "skill_xxx" \
+  --run-id "skill_xxx" \
+  --download-dir "./output"
+```
+
+`query-result` 会查询指定 Run 并输出 JSON。Run 成功完成后下载视频产物，`completed=true`，`videos` 中只包含 `download_url` 和 `output_path`；Run 失败也视为终态，`completed=true` 且填充 `error_message`；Run 未到终态时 `completed=false`。
+
 ## HTTP 客户端
 
 命令模块通过 `common.Runner` 发起服务调用。运行时配置，例如基础地址、HTTP 超时时间和接口路径，由 `internal/config` 加载，并在运行器中与 `common.Client` 组合使用。
 
 ## 鉴权
 
-`short-drama +submit-run`、`get-thread`、`list-thread-file`、`upload-file` 以及 `xyq-skill` Python 脚本都使用 `Authorization: Bearer <XYQ_ACCESS_KEY>` 鉴权。OAuth 命令代码仍保留在仓库中，但短剧运行时请求不使用 OAuth。
+`short-drama +submit-run`、`get-thread`、`list-thread-file`、`short-drama +upload-file` 以及 `xyq-skill` Python 脚本都使用 `Authorization: Bearer <XYQ_ACCESS_KEY>` 鉴权。OAuth 命令代码仍保留在仓库中，但短剧运行时请求不使用 OAuth。

package/checksums.txt

@@ -1,6 +1,6 @@
-95c7bf8bb745dc6e390a8e71ebf9c464769b29f819e3dd9d77d3539453d320b4  pippit-tool-cli-1.0.1-darwin-amd64.tar.gz
-2163023d193b8886518d9b0481ae6306ddfde01de1f6fb61bbbd40a140b75b67  pippit-tool-cli-1.0.1-darwin-arm64.tar.gz
-15962cc45394ee0b204efb88753929b0842c8ad8d74333fe84ba91fe3f3e1596  pippit-tool-cli-1.0.1-linux-amd64.tar.gz
-dbad696c1c212c6d14ef3e9788597d1751386ab7685111832b3ec8b82964bd57  pippit-tool-cli-1.0.1-linux-arm64.tar.gz
-8c298e5200d83d72ddb6c044d63183aa0104ef2b62fb1b0492d3652bfd103f8a  pippit-tool-cli-1.0.1-windows-amd64.zip
-eebeac5fccccbf63e4949efbf92ae2e3518e34b0758a1379cd0f4cc7328e5997  pippit-tool-cli-1.0.1-windows-arm64.zip
+e344cebed19cb97f0aef66df54118cb7425714d614f2488c1072ff72d24d91cf  pippit-tool-cli-1.0.3-darwin-amd64.tar.gz
+a1a516570d4553ef0514442f938da11f0147ad524c9fa7fb078a1ab5d1d0e27d  pippit-tool-cli-1.0.3-darwin-arm64.tar.gz
+b7840c3b3d6cab08d74de8af15a88f09e9bc5f7c98cc14f7d80487edad505bfe  pippit-tool-cli-1.0.3-linux-amd64.tar.gz
+9ef478103cf1e04d825da9a9e1065e76fec6e8e79407fa4543c8010c54ca1bb6  pippit-tool-cli-1.0.3-linux-arm64.tar.gz
+f691764e9d5be6fe2d05b2039318458bb1c5763c5e17060389ba39d2b358f2b6  pippit-tool-cli-1.0.3-windows-amd64.zip
+58899eafda91b4d1c9768d3aaa8d1d04279b7f7f7c2a18541a9873da33882960  pippit-tool-cli-1.0.3-windows-arm64.zip

package/cmd/download_result.go

@@ -44,7 +44,7 @@ func newDownloadResultCommand(stdout, stderr io.Writer, runner *common.Runner) *
 			if err != nil {
 				return err
 			}
-			return writeJSON(stdout, result)
+			return common.WriteJSON(stdout, result)
 		}),
 	}
 	cmd.SetOut(stdout)

package/cmd/generate_video/generate_video.go

@@ -0,0 +1,48 @@
+package generate_video
+
+import (
+	"io"
+	"strconv"
+
+	"github.com/Pippit-dev/pippit-cli/internal/common"
+	internalgen "github.com/Pippit-dev/pippit-cli/internal/generate_video"
+	"github.com/spf13/cobra"
+)
+
+// NewCommand builds the generate-video command.
+func NewCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command {
+	opts := &internalgen.Options{}
+	var durationSec int
+
+	cmd := &cobra.Command{
+		Use:   "generate-video",
+		Short: "Generate a video with the video part agent",
+		Args:  cobra.NoArgs,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			if cmd.Flags().Changed("duration") {
+				opts.DurationSec = &durationSec
+			}
+
+			result, err := internalgen.Run(cmd.Context(), opts, runner)
+			if err != nil {
+				_ = common.AppendDailyErrorLog("generate-video", err, map[string]string{
+					"image_count": strconv.Itoa(len(opts.ImagePaths)),
+					"video_count": strconv.Itoa(len(opts.VideoPaths)),
+				})
+				return err
+			}
+			return common.WriteJSON(stdout, result)
+		},
+	}
+	cmd.SetOut(stdout)
+	cmd.SetErr(stderr)
+	flags := cmd.Flags()
+	flags.StringVar(&opts.Prompt, "prompt", "", "video generation prompt")
+	flags.StringArrayVar(&opts.ImagePaths, "image", nil, "local reference image path; repeat for multiple images, up to 9")
+	flags.StringArrayVar(&opts.VideoPaths, "video", nil, "local reference video path; repeat for multiple videos, up to 3")
+	flags.IntVar(&durationSec, "duration", 0, "video duration in seconds")
+	flags.StringVar(&opts.Ratio, "ratio", "", "video ratio, such as 9:16, 16:9, 3:4, 4:3")
+	flags.StringVar(&opts.Model, "model", "", "video model; normal users: seedance2.0_direct, seedance2.0_fast_direct; VIP users: seedance2.0_direct, seedance2.0_fast_direct, seedance2.0_vision, seedance2.0_fast_vision")
+	flags.StringVar(&opts.Resolution, "resolution", "", "video resolution, such as 720p, 1080p")
+	return cmd
+}

package/cmd/generate_video/query_result.go

@@ -0,0 +1,42 @@
+package generate_video
+
+import (
+	"encoding/json"
+	"io"
+	"strings"
+
+	"github.com/Pippit-dev/pippit-cli/internal/common"
+	internalgen "github.com/Pippit-dev/pippit-cli/internal/generate_video"
+	"github.com/spf13/cobra"
+)
+
+// NewQueryResultCommand builds the query-result command.
+func NewQueryResultCommand(stdout, stderr io.Writer, runner *common.Runner) *cobra.Command {
+	opts := &internalgen.QueryResultOptions{}
+
+	cmd := &cobra.Command{
+		Use:   "query-result",
+		Short: "Query a generate-video run result and download completed videos",
+		Args:  cobra.NoArgs,
+		RunE: func(cmd *cobra.Command, _ []string) error {
+			result, err := internalgen.QueryResult(cmd.Context(), opts, runner)
+			if err != nil {
+				_ = common.AppendDailyErrorLog("query-result", err, map[string]string{
+					"thread_id":    strings.TrimSpace(opts.ThreadID),
+					"run_id":       strings.TrimSpace(opts.RunID),
+					"download_dir": strings.TrimSpace(opts.DownloadDir),
+				})
+				return err
+			}
+			encoder := json.NewEncoder(stdout)
+			encoder.SetIndent("", "  ")
+			return encoder.Encode(result)
+		},
+	}
+	cmd.SetOut(stdout)
+	cmd.SetErr(stderr)
+	cmd.Flags().StringVar(&opts.ThreadID, "thread-id", "", "thread_id from generate-video output")
+	cmd.Flags().StringVar(&opts.RunID, "run-id", "", "run_id from generate-video output")
+	cmd.Flags().StringVar(&opts.DownloadDir, "download-dir", "", "directory to download completed videos into")
+	return cmd
+}