\r \r

OpenClaw Media Gen 🎬\r

\r 用 AIsa API 一把钥匙生成图片与视频：\r \r

• 图片：gemini-3-pro-image-preview（Gemini GenerateContent）\r
• 视频：wan2.6-t2v（通义万相 / Qwen Wan 2.6，异步任务）\r \r API 文档索引见 AIsa API Reference（可从 https://docs.aisa.one/llms.txt 找到所有页面）。\r \r

🔥 你可以做什么\r

\r

图片生成（Gemini）\r

"生成一张赛博朋克风格的城市夜景，霓虹灯，雨夜，电影感"\r
```\r
\r
### 视频生成（Wan 2.6）\r
```\r
"用一张参考图生成 5 秒镜头：镜头缓慢推进，风吹动头发，电影感，浅景深"\r
```\r
\r
## Quick Start\r
\r
```bash\r
export AISA_API_KEY="your-key"\r
```\r
\r
---\r
\r
## 🖼️ Image Generation (Gemini)\r
\r
### Endpoint\r
\r
- Base URL: `https://api.aisa.one/v1`\r
- `POST /models/{model}:generateContent`\r
\r
文档：`google-gemini-chat`（GenerateContent）见 `https://docs.aisa.one/reference/generatecontent`。\r
\r
### curl 示例（返回 inline_data 时为图片）\r
\r
```bash\r
curl -X POST "https://api.aisa.one/v1/models/gemini-3-pro-image-preview:generateContent" \\r
  -H "Authorization: Bearer $AISA_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "contents":[\r
      {"role":"user","parts":[{"text":"A cute red panda, ultra-detailed, cinematic lighting"}]}\r
    ]\r
  }'\r
```\r
\r
> 说明：该接口的响应中可能出现 `candidates[].parts[].inline_data`（通常包含 base64 数据与 mime 类型）；客户端脚本会自动解析并保存文件。\r
\r
---\r
\r
## 🎞️ Video Generation (Qwen Wan 2.6 / Tongyi Wanxiang)\r
\r
### Create task\r
\r
- Base URL: `https://api.aisa.one/apis/v1`\r
- `POST /services/aigc/video-generation/video-synthesis`\r
- Header：`X-DashScope-Async: enable`（必填，异步）\r
\r
文档：`video-generation` 见 `https://docs.aisa.one/reference/post_services-aigc-video-generation-video-synthesis`。\r
\r
```bash\r
curl -X POST "https://api.aisa.one/apis/v1/services/aigc/video-generation/video-synthesis" \\r
  -H "Authorization: Bearer $AISA_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -H "X-DashScope-Async: enable" \\r
  -d '{\r
    "model":"wan2.6-t2v",\r
    "input":{\r
      "prompt":"cinematic close-up, slow push-in, shallow depth of field",\r
      "img_url":"https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/320px-Cat03.jpg"\r
    },\r
    "parameters":{\r
      "resolution":"720P",\r
      "duration":5,\r
      "shot_type":"single",\r
      "watermark":false\r
    }\r
  }'\r
```\r
\r
### Poll task\r
\r
- `GET /services/aigc/tasks?task_id=...`\r
\r
文档：`task` 见 `https://docs.aisa.one/reference/get_services-aigc-tasks`。\r
\r
```bash\r
curl "https://api.aisa.one/apis/v1/services/aigc/tasks?task_id=YOUR_TASK_ID" \\r
  -H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
---\r
\r
## Python Client\r
\r
```bash\r
# 生成图片（保存到本地文件）\r
python3 {baseDir}/scripts/media_gen_client.py image \\r
  --prompt "A cute red panda, cinematic lighting" \\r
  --out "out.png"\r
\r
# 创建视频任务（需要 img_url）\r
python3 {baseDir}/scripts/media_gen_client.py video-create \\r
  --prompt "cinematic close-up, slow push-in" \\r
  --img-url "https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/320px-Cat03.jpg" \\r
  --duration 5\r
\r
# 轮询任务状态\r
python3 {baseDir}/scripts/media_gen_client.py video-status --task-id YOUR_TASK_ID\r
\r
# 等待直到成功（可选：成功后打印 video_url）\r
python3 {baseDir}/scripts/media_gen_client.py video-wait --task-id YOUR_TASK_ID --poll 10 --timeout 600\r
\r
# 等待直到成功并自动下载 mp4\r
python3 {baseDir}/scripts/media_gen_client.py video-wait --task-id YOUR_TASK_ID --download --out out.mp4\r
```\r
\r