名称： yollomi-ai-api
描述： AI 图像生成技能（图像、图像生成）。Yollomi 的多模型图像生成器，通过统一的 API 端点生成 AI 图像。需要 YOLLOMI_API_KEY。
元数据： {"openclaw":{"requires":{"env":["YOLLOMI_API_KEY"]}}}

Yollomi AI API 技能

通过 Yollomi API 生成图像和视频。所有模型均使用单一统一端点，通过不同的 modelId 参数进行区分。

设置

1. API 密钥：设置环境变量 YOLLOMI_API_KEY。

注意：
* 此技能版本中视频生成功能暂时禁用。

统一端点

POST /api/v1/generate

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

请求体：
* type (必需)："image" 或 "video"
* modelId (必需)：模型标识符
* 其他参数取决于具体模型（如 prompt、imageUrl 等）

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

列出模型

GET /api/v1/models

返回所有可用的图像和视频模型 ID。

常用示例

生成图像（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"}'

生成视频：

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"}'

宽高比 (aspectRatio)

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

图像模型 ID

视频模型 ID

使用流程

1. 生成图像 → 向 /api/v1/generate 发送 POST 请求，包含 type: "image"、modelId 及模型特定参数。
2. 生成视频 → 向 /api/v1/generate 发送 POST 请求，包含 type: "video"、modelId、prompt，以及可选的 inputs。
3. 列出模型 → 发送 GET 请求到 /api/v1/models。
4. 遇到 401/402 错误 → 检查 API 密钥和剩余点数。

参考

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