介绍
# Yollomi AI API Skill
通过 Yollomi API 生成图像和视频。所有模型使用**统一端点**并配合不同的 `modelId` 参数。
## 设置
1. **API Key**：设置 `YOLLOMI_API_KEY`（环境变量）。
注意： - 在此技能构建中，视频生成暂时已禁用。
## 统一端点
``` POST /api/v1/generate ```
**Headers**：`Authorization: Bearer ${YOLLOMI_API_KEY}` 或 `X-API-Key: ${YOLLOMI_API_KEY}` **Content-Type**: `application/json`
**Body**： - `type`（必填）：`"image"` 或 `"video"` - `modelId`（必填）：模型标识符 - 其他参数取决于模型（prompt、imageUrl 等）
**响应（图像）**：`{ images: string[], remainingCredits: number }` **响应（视频）**：`{ video: string, remainingCredits: number }`
## 列出模型
``` GET /api/v1/models ```
返回所有可用的图像和视频 modelId。
## 常见示例
**生成图像**： ```bash 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"}' ```
**移除背景**： ```bash 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"}' ```
**生成视频**： ```bash 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"}' ```
## 宽高比
文生图模型支持的宽高比：
| ratio | description | |------|-------------| | 1:1 | 正方形（默认） | | 16:9 | 横向 | | 9:16 | 纵向 |
## 图像模型 ID
| modelId | Credits | Required | aspectRatio | |---------|---------|----------|-------------| | flux | 4/img | prompt | 1:1, 16:9, 9:16 | | flux-schnell | 2/img | prompt | 同上 | | flux-2-pro | 15/img | prompt | 同上 | | remove-bg | 0 | imageUrl | - | | nano-banana | 4 | prompt | 1:1, 16:9, 9:16 | | nano-banana-pro | 15 | prompt | 同上 | | flux-kontext-pro | 4 | prompt | 同上 | | z-image-turbo | 1 | prompt | width, height | | imagen-4-ultra | 6 | prompt | 同上 | | image-4-fast | 3 | prompt | 同上 | | ideogram-v3-turbo | 3 | prompt | 同上 | | stable-diffusion-3-5-large | 7/img | prompt | 同上 | | seedream-4-5 | 4 | prompt | 同上 | | object-remover | 3 | image, mask | - | | face-swap | 3 | swapImage, inputImage | - | | image-upscaler | 1 | imageUrl, scale | - | | photo-restoration | 4 | imageUrl | - | | qwen-image-edit | 3 | image, prompt | - | | qwen-image-edit-plus | 3 | image, prompt | - | | virtual-try-on | 3 | clothImage, personImage | - | | ai-background-generator | 5 | imageUrl | prompt |
## 视频模型 ID
| modelId | Credits | |---------|---------| | openai-sora-2 | ~50+ | | google-veo-3 | 10 | | google-veo-3-fast | 9 | | google-veo-3-1 | 10 | | google-veo-3-2 | 10 | | google-veo-3-1-fast | 9 | | kling-2-1 | 9 | | kling-v2-6-motion-control | 7/sec | | minimax-hailuo-2-3 | 9 | | minimax-hailuo-2-3-fast | 9 | | bytedance-seedance-1-pro-fast | 8 | | runway-gen4-turbo | 视情况而定 | | pixverse-5 | 9 | | wan-2-5-i2v | 9 | | wan-2-5-t2v | 9 | | wan-2-6-i2v | 29 | | wan-2-6-t2v | 29 |
## 工作流
1. **生成图像** → POST /api/v1/generate，携带 `type: "image"`、`modelId` 和模型参数 2. **生成视频** → POST /api/v1/generate，携带 `type: "video"`、`modelId`、`prompt` 和可选的 `inputs` 3. **列出模型** → GET /api/v1/models 4. **401/402** → 检查 API key 和积分余额
## 参考
完整模型列表和参数：[models-reference.md](models-reference.md) 或 GET /api/v1/models