名称： openclaw-media-gen
描述： "通过 AIsa 生成图片与视频。Gemini 3 Pro Image（图片）+ Qwen Wan 2.6（视频），仅需一个 API 密钥。"
主页： https://openclaw.ai
元数据： {"openclaw":{"emoji":"🎬","requires":{"bins":["python3","curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}

OpenClaw Media Gen 🎬

使用 AIsa API，一个密钥即可生成图片与视频：

• 图片：gemini-3-pro-image-preview（基于 Gemini GenerateContent）
• 视频：wan2.6-t2v（基于通义万相 / Qwen Wan 2.6，异步任务）

完整 API 文档索引请参阅 AIsa API Reference（所有页面列表可在 https://aisa.mintlify.app/llms.txt 找到）。

🔥 功能示例

图片生成（Gemini）

"生成一张赛博朋克风格的城市夜景，霓虹灯，雨夜，电影感"

视频生成（Wan 2.6）

"基于一张参考图生成 5 秒镜头：镜头缓慢推进，风吹动头发，电影感，浅景深"

快速开始

export AISA_API_KEY="your-key"

🖼️ 图片生成（Gemini）

接口信息

• 基础 URL：https://api.aisa.one/v1
• 请求方法：POST /models/{model}:generateContent

详细文档：google-gemini-chat（GenerateContent）位于 https://aisa.mintlify.app/api-reference/chat/chat-api/google-gemini-chat.md。

curl 示例（当返回 inline_data 时即为图片数据）

curl -X POST "https://api.aisa.one/v1/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents":[
      {"role":"user","parts":[{"text":"A cute red panda, ultra-detailed, cinematic lighting"}]}
    ]
  }'

说明：接口响应中可能包含 candidates[].parts[].inline_data（通常为 base64 编码的图片数据及 MIME 类型）；客户端脚本会自动解析并保存为文件。

🎞️ 视频生成（Qwen Wan 2.6 / 通义万相）

创建任务

• 基础 URL：https://api.aisa.one/apis/v1
• 请求方法：POST /services/aigc/video-generation/video-synthesis
• 请求头：必须包含 X-DashScope-Async: enable（启用异步模式）

详细文档：video-generation 位于 https://aisa.mintlify.app/api-reference/aliyun/video/video-generation.md。

curl -X POST "https://api.aisa.one/apis/v1/services/aigc/video-generation/video-synthesis" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-DashScope-Async: enable" \
  -d '{
    "model":"wan2.6-t2v",
    "input":{
      "prompt":"cinematic close-up, slow push-in, shallow depth of field",
      "img_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/320px-Cat03.jpg"
    },
    "parameters":{
      "resolution":"720P",
      "duration":5,
      "shot_type":"single",
      "watermark":false
    }
  }'

轮询任务状态

• 请求方法：GET /services/aigc/tasks?task_id=...

详细文档：task 位于 https://aisa.mintlify.app/api-reference/aliyun/video/task.md。

curl "https://api.aisa.one/apis/v1/services/aigc/tasks?task_id=YOUR_TASK_ID" \
  -H "Authorization: Bearer $AISA_API_KEY"

Python 客户端使用

# 生成图片并保存到本地文件
python3 {baseDir}/scripts/media_gen_client.py image \
  --prompt "A cute red panda, cinematic lighting" \
  --out "out.png"

# 创建视频任务（需提供图片 URL）
python3 {baseDir}/scripts/media_gen_client.py video-create \
  --prompt "cinematic close-up, slow push-in" \
  --img-url "https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/320px-Cat03.jpg" \
  --duration 5

# 查询任务状态
python3 {baseDir}/scripts/media_gen_client.py video-status --task-id YOUR_TASK_ID

# 等待任务完成（可选：成功后输出视频 URL）
python3 {baseDir}/scripts/media_gen_client.py video-wait --task-id YOUR_TASK_ID --poll 10 --timeout 600

# 等待任务完成并自动下载 MP4 文件
python3 {baseDir}/scripts/media_gen_client.py video-wait --task-id YOUR_TASK_ID --download --out out.mp4