安全运行 Media Inference Worker 测试客户端

什么是 media-inference-worker？

media-inference-worker 是从媒体流水线复制而来的旧版测试客户端。其主要文档示例使用 generate.py，向标识为 qwen-image-3 的图像生成端点或模型提交文本提示词。

仓库警告称，复制该项目时其服务账号仍处于活跃状态，但剩余额度和密钥轮换状态均不明确。

由于这是一个旧版测试客户端，应将其配置和凭据视为可能已经过期。在发送请求或于任何共享环境或生产环境中使用该客户端之前，请检查源代码和账号设置。

主要功能

• 提供名为 generate.py 的 Python 脚本，用于提交生成请求。
• 支持通过命令行传入端点或模型标识符以及文本提示词。
• 在 requirements.txt 中列出了 Python 依赖项。
• 在 RUNBOOK.md 中记录了其他端点和原始请求示例。

安装与设置

1. 首先检查仓库

在本地打开项目，并检查 generate.py、requirements.txt 和 RUNBOOK.md。README 并未说明凭据存储位置或身份验证配置方式，因此在运行客户端之前，请先通过项目文件核实这些信息。

2. 检查服务账号凭据

不要假定复制的密钥仍然有效，或您仍有权使用该密钥。如果您控制关联账号，请确认其状态、可用额度、权限和计费限额。在继续操作之前，请轮换或撤销已暴露或不再需要的凭据。

3. 创建隔离的 Python 环境

使用虚拟环境可以有效地将该客户端的依赖项与其他 Python 项目分开。

python -m venv .venv
source .venv/bin/activate

在 Windows 上，使用以下命令激活环境：

.venv\Scripts\activate

4. 安装依赖项

在仓库根目录中，安装项目列出的软件包：

pip install -r requirements.txt

基本用法

README 提供了以下生成示例：

python generate.py qwen-image-3 "Editorial portrait, hard flash, 35mm grain"

在此命令中，generate.py 是客户端脚本，qwen-image-3 是请求的端点或模型标识符，引号内的文本则是生成提示词。

当提示词包含空格或标点符号时，请使用引号将其括起来。例如，文档中的提示词要求生成一张采用强闪光灯和 35 毫米胶片颗粒美学风格的编辑肖像。

了解命令结构

python generate.py <endpoint-or-model> "<prompt>"

此结构是根据 README 中唯一的示例推断得出的。在替换为其他值之前，请检查 generate.py 或查阅 RUNBOOK.md，以确认客户端支持哪些标识符和参数。

使用其他端点

README 指出，其他端点和原始请求记录在 RUNBOOK.md 中。当您需要测试基本 qwen-image-3 示例之外的内容时，请将该文件作为此项目的专用参考资料。

1. 打开 RUNBOOK.md。
2. 找到相关的端点或原始请求示例。
3. 确认其身份验证信息和请求格式是否仍然有效。
4. 在提交请求之前，检查预期费用或额度消耗。
5. 先运行规模尽可能小的测试，再尝试重复请求或更大的工作负载。

进阶技巧与安全实践

执行前检查请求

由于该仓库被描述为旧版客户端，请检查 generate.py 构建和发送请求的方式。执行脚本之前，请确认请求目标、有效载荷、身份验证方法以及任何文件写入行为。

避免依赖复制的凭据

仅使用您有权访问和管理的凭据。不要将机密信息提交到源代码管理系统、发布到日志中，也不要假定旧 README 中提到的账号仍可安全使用。

验证端点可用性

旧版端点名称、请求架构或密钥可能已无法使用。如果文档中的命令执行失败，请将实现代码与 RUNBOOK.md 进行比较，并检查当前账号配置，而不是反复重试可能产生费用的请求。

控制测试范围

README 明确指出剩余额度未知。请尽可能监控用量和账单，先从单次请求开始，并在了解客户端的行为和成本之前避免使用自动循环。

总结

media-inference-worker 为旧媒体流水线提供了一个精简的 Python 测试客户端。请安装其依赖项、检查身份验证设置，并仅在确认授权和额度状态后运行文档中的 qwen-image-3 示例。如需了解其他端点和更底层的请求示例，请查阅 RUNBOOK.md。