qingyun-api

name	qingyun-api
description	Qingyun unified API — image generation, video, TTS, and embedding via single gateway

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)

Model ID	名称	格式	特点
gemini-3-pro-image-preview	Gemini 3 Pro 图片	Gemini 原生	支持宽高比+清晰度控制，原生图片生成最强
grok-imagine-image-pro	Grok Image Pro	Grok 系列	xAI 旗舰生图模型，写实/创意能力强

🎞️ 图片转动图 (1)

Model ID	名称	格式	特点
andreasjansson/stable-diffusion-animation	SD Animation	Replicate task	Stable Diffusion 动画生成，支持参数调节帧数/平滑度

🎬 视频生成 (7)

Model ID	名称	格式	特点	分层
sora-2-all	Sora 2	Sora 统一格式	OpenAI 旗舰视频，文/图生视频	T0 顶级
sora-2-pro-all	Sora 2 Pro	Sora 统一格式	Sora增强版，更长更高质量	T0 顶级
veo_3_1-fast-4K	Veo 3.1 Fast 4K	Veo 统一格式	Google 4K视频，速度快	T1 高端
veo_3_1-components-4K	Veo 3.1 Components	Veo 统一格式	Veo组件化视频生成	T1 高端
grok-video-3-10s	Grok Video 3	Grok 视频格式	xAI 视频，10秒短视频	T2 中端
doubao-seedance-1-5-pro-251215	豆包 Seedance 1.5 Pro	豆包格式	字节跳动旗舰视频，首尾帧支持	T1 高端
doubao-seedance-1-0-pro-fast-251015	豆包 Seedance 1.0 Pro Fast	豆包格式	Seedance快速版	T2 中端

🔊 音频/TTS (4)

Model ID	名称	格式	特点
gpt-4o-audio-preview	GPT-4o Audio	OpenAI Chat	音频输入+输出，多模态对话
gemini-2.5-flash-preview-tts	Gemini 2.5 Flash TTS	Gemini 原生	Google 快速TTS，多语言
gemini-2.5-pro-preview-tts	Gemini 2.5 Pro TTS	Gemini 原生	Google 旗舰TTS，音质最佳
kling-audio	可灵音效	Kling 文生音效	文字生成音效

🎨 特效/高级 (4)

Model ID	名称	格式	特点
kling-v2-5-turbo	可灵数字人视频	Kling 图生视频	图片转数字人说话视频（需配合 voice_list 参数）
kling-advanced-lip-sync	可灵高级对口型	Kling 对口型	精准视频对口型/人脸识别
kling-effects	可灵视频特效	Kling 视频特效	视频特效滤镜/风格迁移
gemini-embedding-2-preview	Gemini Embedding	OpenAI 兼容	文本向量化（embedding）

⚠️ 重要更正（2026-04-08）

• kling-avatar-image2video 不是有效的模型名（青云API会返回500错误）
• 数字人视频正确调用方式：POST /kling/v1/videos/image2video + model_name: kling-v2-5-turbo
• 如需带音色，使用 voice_list 参数指定音色ID，并用 <<<voice_1>>> 在 prompt 中引用
• Daniel 要求的 /kling/v1/videos/avatar/image2video 端点不存在，数字人功能走标准 /kling/v1/videos/image2video 接口

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 环境变量引用

数字人/可灵avatar API 完整调用方法

端点: POST https://api.qingyuntop.top/kling/v1/videos/image2video 查询: GET https://api.qingyuntop.top/kling/v1/videos/image2video/{task_id}

{
  "model_name": "kling-v2-5-turbo",
  "image": "<base64或URL>",
  "prompt": "男人<<<voice_1>>>说：你好",
  "negative_prompt": "animation, cartoon",
  "duration": "5",
  "aspect_ratio": "9:16",
  "mode": "std",
  "cfg_scale": 0.3,
  "voice_list": [{"voice_id": "<音色ID>"}],
  "sound": "on"
}

说明:

• voice_list: 指定音色列表（最多2个音色），配合 prompt 中 <<<voice_N>>> 引用
• sound: on: 开启音频生成（有音视频则按"有指定音色"计费）
• mode: std（标准/性价比高）| pro（高品质/高表现）
• 脚本位置: scripts/qingyun-video-kling.sh（已实现，支持 voice_list）

Gemini 图生图 API（补充 2026-04-08）

青云支持两种 Gemini 图生图调用方式：

方式1: Gemini 原生格式

curl -X POST "https://api.qingyuntop.top/v1beta/models/gemini-3-pro-image-preview:generateContent?key=$QINGYUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": {"parts": [{"text": "生成一张图片"}]},
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "16:9"}
    }
  }'

方式2: Chat 兼容格式（推荐，更简单）

curl -X POST "https://api.qingyuntop.top/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $QINGYUN_API_KEY" \
  -d '{"model": "gemini-3-pro-image-preview", "messages": [{"role": "user", "content": "生成一张图片"}]}'

脚本位置: scripts/qingyun-image-gemini.sh

官方文档

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