Qingyun API

qingyun-api Skill

青云聚合API多模态调用 Skill — 覆盖生图、生视频、语音、Embedding 等能力。

触发条件

• qingyun、青云、青云API、qingyun-api
• 生图/生视频/语音合成时指定 model=gemini-3-pro-image-preview 等青云模型ID

API 配置

• Base URL: https://api.qingyuntop.top
• API Key: pass show api/qingyun → QINGYUN_API_KEY 环境变量
• 充值汇率: 0.79元 = $1（限时特价分组再6折）
• 并发: 无限
• 域名: 主 api.qingyuntop.top / 备用 api.qingyunjuhe.top

模型档案 (18个)

🖼️ 图片生成 (2)

🎞️ 图片转动图 (1)

🎬 视频生成 (7)

🔊 音频/TTS (4)

🎨 特效/高级 (4)

API 格式分类

OpenAI 兼容格式 (可直接用 openai 库)

• gemini-embedding-2-preview → POST /v1/embeddings
• gpt-4o-audio-preview → POST /v1/chat/completions (带 audio modality)

Chat 兼容格式 (messages → 图片base64)

• gemini-3-pro-image-preview → 可通过 chat 兼容格式调用
• grok-imagine-image-pro → Grok 系列 chat 格式

Task 异步格式 (创建任务 → 轮询 → 获取结果)

• 视频模型: sora, veo, grok-video, doubao-seedance, kling-avatar
• Replicate: stable-diffusion-animation
• Kling 特效: kling-effects, kling-advanced-lip-sync, kling-audio

Gemini 原生格式

• Gemini TTS: gemini-2.5-flash/pro-preview-tts
• Gemini 图片: gemini-3-pro-image-preview (原生格式更灵活)

脚本目录

scripts/
├── qingyun-common.sh        # 公共函数（API key、base URL、错误处理）
├── qingyun-embedding.sh     # gemini-embedding-2-preview
├── qingyun-image-gemini.sh  # gemini-3-pro-image-preview
├── qingyun-image-grok.sh    # grok-imagine-image-pro
├── qingyun-sd-animation.sh  # andreasjansson/stable-diffusion-animation
├── qingyun-video-sora.sh    # sora-2-all, sora-2-pro-all
├── qingyun-video-veo.sh     # veo_3_1-fast-4K, veo_3_1-components-4K
├── qingyun-video-grok.sh    # grok-video-3-10s
├── qingyun-video-doubao.sh  # doubao-seedance-*
├── qingyun-video-kling.sh   # kling-avatar-image2video
├── qingyun-audio-gpt4o.sh   # gpt-4o-audio-preview
├── qingyun-tts-gemini.sh    # gemini-2.5-flash/pro-preview-tts
├── qingyun-audio-kling.sh   # kling-audio
├── qingyun-lipsync-kling.sh # kling-advanced-lip-sync
├── qingyun-effects-kling.sh # kling-effects
└── qingyun-test-all.sh      # 全量测试脚本

使用方式

# 设置 API key（或在 .env 中配置）
export QINGYUN_API_KEY=$(pass show api/qingyun)

# 调用
bash ~/clawd/skills/qingyun-api/scripts/qingyun-embedding.sh "测试文本"
bash ~/clawd/skills/qingyun-api/scripts/qingyun-image-gemini.sh "一只可爱的猫咪" --ratio 16:9
bash ~/clawd/skills/qingyun-api/scripts/qingyun-video-sora.sh "日落时分海边漫步" --model sora-2-all

2026-04-06 实战沉淀：内容封面默认走法

适用场景

• 小红书封面
• 公众号头图
• 需要“内容表达准确”优先于“随机创意”的封面生成

推荐组合

• 提示词方法论：先用 content-cover-gen
• 实际生图执行：再用本 skill 的 scripts/qingyun-image-gemini.sh
• 默认模型：gemini-3-pro-image-preview
• 默认取 key：pass show api/qingyun | head -n 1

小红书封面推荐命令

export QINGYUN_API_KEY="$(pass show api/qingyun | head -n 1)"
bash ~/clawd/skills/qingyun-api/scripts/qingyun-image-gemini.sh \
  "Split-scene editorial illustration, left side active thinking with warm brain glow, right side passive AI overuse with dim blue brain, strong visual metaphor, no text overlay" \
  --ratio 3:4 \
  -o /path/to/xhs-cover

和 xhs-smart-publisher 的协作细节（新增）

• 出图完成后，优先把文件命名到文章目录下，例如：cover-3-qingyun.jpg
• 如果后续要交给 browser 上传，记得再复制到：/tmp/openclaw/uploads/
• 文章元数据里的 🖼️ 封面：待生成 要同步替换成真实文件路径
• 这一步完成后，才交给 xhs-smart-publisher 进入发布页

注意事项

• gemini-3.1-image-pro 是口头说法；当前本地实际可用模型名是 gemini-3-pro-image-preview
• 输出文件会根据接口返回格式落成图片（如 .jpg）
• 做内容封面时，先定隐喻再出图；不要上来就丢一句泛 prompt
• 如果是给小红书发文服务，默认认为下游会走 xhs-smart-publisher，所以输出路径、命名、比例都要为发布动作服务

安全

• API key 从 pass show api/qingyun 获取，永不明文写入脚本
• 脚本内部通过 $QINGYUN_API_KEY 环境变量引用

官方文档

• API 文档: https://qingyuntop.apifox.cn/
• 定价页: https://api.qingyuntop.top/pricing
• OpenClaw 配置教程: https://qingyuntop.apifox.cn/doc-8310795