Yollomi AI API 技能

通过 Yollomi API 生成图像和视频。所有模型使用一个统一的端点，通过不同的模型ID参数来区分。

设置

1. API密钥：设置YOLLOMI_API_KEY（环境变量）。
2. 基础URL（可选）：设置YOLLOMI_BASE_URL以覆盖默认的API主机（默认为：https://yollomi.com）。

统一端点

POST /api/v1/generate

请求头：Authorization: Bearer ${YOLLOMI_API_KEY}或X-API-Key: ${YOLLOMI_API_KEY}
Content-Type：application/json

Body：

• type（必需）："image"或"video"
• modelId（必需）：模型标识符
• 附加参数取决于模型（提示词、图片地址等）

响应（图片）：{ images: string[], remainingCredits: number }
响应（视频）：{ video: string, remainingCredits: number }

列出模型

GET /api/v1/models

返回所有可用的图片和视频模型标识符。

常见示例

生成图片（Flux）：

curl -X POST "${YOLLOMI_BASE_URL:-https://yollomi.com}/api/v1/generate" \
  -H "Authorization: Bearer $YOLLOMI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","modelId":"flux","prompt":"A cat in a hat","aspectRatio":"1:1"}'

移除背景：

curl -X POST "${YOLLOMI_BASE_URL:-https://yollomi.com}/api/v1/generate" \
  -H "Authorization: Bearer $YOLLOMI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"image","modelId":"remove-bg","imageUrl":"https://example.com/photo.jpg"}'

生成视频长宽比 (aspectRatio)

curl -X POST "${YOLLOMI_BASE_URL:-https://yollomi.com}/api/v1/generate" \
  -H "Authorization: Bearer $YOLLOMI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"video","modelId":"kling-2-1","prompt":"A cat walking in the rain"}'

文生图模型支持的宽高比：

宽高比

模型ID

视频模型ID

OpenClaw Tools

工作流程

1. 列出模型→yollomi.listModels()或 GET /api/v1/models
2. 生成图片→yollomi.generate({ type: "image", modelId, prompt, ... })
3. 生成视频→yollomi.generate({ type: "video", modelId, prompt, inputs: { ... } })
4. 401/402→ 检查 API 密钥和积分

参考

完整模型列表和参数：models-reference.md或 GET /api/v1/models