Yollomi AI API Skill
Generates images and videos via the Yollomi API. All models use a single unified endpoint with different modelId parameters.
Setup
- API Key: Set
YOLLOMI_API_KEY (environment variable).
- Base URL (optional): Set
YOLLOMI_BASE_URL to override API host (default: https://yollomi.com).
Unified Endpoint
POST /api/v1/generate
Headers: Authorization: Bearer ${YOLLOMI_API_KEY} or X-API-Key: ${YOLLOMI_API_KEY}
Content-Type: application/json
Body:
type (required): "image" or "video"modelId (required): Model identifier- Additional params depend on model (prompt, imageUrl, etc.)
Response (image): { images: string[], remainingCredits: number }
Response (video): { video: string, remainingCredits: number }
List Models
GET /api/v1/models
Returns all available image and video modelIds.
Common Examples
Generate image (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"}'
Remove background:
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"}'
Generate video:
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"}'
Aspect Ratio (aspectRatio)
Supported aspect ratios for text-to-image models:
| ratio |
description |
| 1:1 |
Square (default) |
| 16:9 |
Landscape |
| 9:16 |
Portrait |
Image ModelIds
| modelId |
Credits |
Required |
aspectRatio |
| flux |
4/img |
prompt |
1:1, 16:9, 9:16 |
| flux-schnell |
2/img |
prompt |
same as above |
| flux-2-pro |
15/img |
prompt |
same as above |
| remove-bg |
0 |
imageUrl |
- |
| nano-banana |
4 |
prompt |
1:1, 16:9, 9:16 |
| nano-banana-pro |
15 |
prompt |
same as above |
| flux-kontext-pro |
4 |
prompt |
same as above |
| z-image-turbo |
1 |
prompt |
width, height |
| imagen-4-ultra |
6 |
prompt |
same as above |
| image-4-fast |
3 |
prompt |
same as above |
| ideogram-v3-turbo |
3 |
prompt |
same as above |
| stable-diffusion-3-5-large |
7/img |
prompt |
same as above |
| seedream-4-5 |
4 |
prompt |
same as above |
| 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 |
Video ModelIds
| modelId |
Credits |
| openai-sora-2 |
~50+ |
| google-veo-3 |
10 |
| google-veo-3-fast |
9 |
| google-veo-3-1 |
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 |
varies |
| pixverse-5 |
9 |
| wan-2-5-i2v |
9 |
| wan-2-5-t2v |
9 |
| wan-2-6-i2v |
29 |
| wan-2-6-t2v |
29 |
OpenClaw Tools
| Tool |
Description |
yollomi.generate |
Generate image or video. Params: type, modelId, prompt, imageUrl, aspectRatio, numOutputs, inputs (video) |
yollomi.listModels |
List all available image and video models with credit costs. No auth required. |
Workflow
- List models →
yollomi.listModels() or GET /api/v1/models
- Generate image →
yollomi.generate({ type: "image", modelId, prompt, ... })
- Generate video →
yollomi.generate({ type: "video", modelId, prompt, inputs: { ... } })
- 401/402 → Check API key and credits
Reference
Full model list and params: models-reference.md or GET /api/v1/models
1---2name: yollomi-ai-api3description: AI image generator skill (image, image generation). Multi-model image generator for Yollomi to generate AI images via one unified API endpoint. Requires YOLLOMI_API_KEY.4---56# Yollomi AI API Skill78Generates images and videos via the Yollomi API. All models use a **single unified endpoint** with different `modelId` parameters.910## Setup11121. **API Key**: Set `YOLLOMI_API_KEY` (environment variable).132. **Base URL** (optional): Set `YOLLOMI_BASE_URL` to override API host (default: `https://yollomi.com`).1415## Unified Endpoint1617```18POST /api/v1/generate19```2021**Headers**: `Authorization: Bearer ${YOLLOMI_API_KEY}` or `X-API-Key: ${YOLLOMI_API_KEY}` 22**Content-Type**: `application/json`2324**Body**:25- `type` (required): `"image"` or `"video"`26- `modelId` (required): Model identifier27- Additional params depend on model (prompt, imageUrl, etc.)2829**Response (image)**: `{ images: string[], remainingCredits: number }` 30**Response (video)**: `{ video: string, remainingCredits: number }`3132## List Models3334```35GET /api/v1/models36```3738Returns all available image and video modelIds.3940## Common Examples4142**Generate image (Flux)**:43```bash44curl -X POST "${YOLLOMI_BASE_URL:-https://yollomi.com}/api/v1/generate" \45 -H "Authorization: Bearer $YOLLOMI_API_KEY" \46 -H "Content-Type: application/json" \47 -d '{"type":"image","modelId":"flux","prompt":"A cat in a hat","aspectRatio":"1:1"}'48```4950**Remove background**:51```bash52curl -X POST "${YOLLOMI_BASE_URL:-https://yollomi.com}/api/v1/generate" \53 -H "Authorization: Bearer $YOLLOMI_API_KEY" \54 -H "Content-Type: application/json" \55 -d '{"type":"image","modelId":"remove-bg","imageUrl":"https://example.com/photo.jpg"}'56```5758**Generate video**:59```bash60curl -X POST "${YOLLOMI_BASE_URL:-https://yollomi.com}/api/v1/generate" \61 -H "Authorization: Bearer $YOLLOMI_API_KEY" \62 -H "Content-Type: application/json" \63 -d '{"type":"video","modelId":"kling-2-1","prompt":"A cat walking in the rain"}'64```6566## Aspect Ratio (aspectRatio)6768Supported aspect ratios for text-to-image models:6970| ratio | description |71|------|-------------|72| 1:1 | Square (default) |73| 16:9 | Landscape |74| 9:16 | Portrait |7576## Image ModelIds7778| modelId | Credits | Required | aspectRatio |79|---------|---------|----------|-------------|80| flux | 4/img | prompt | 1:1, 16:9, 9:16 |81| flux-schnell | 2/img | prompt | same as above |82| flux-2-pro | 15/img | prompt | same as above |83| remove-bg | 0 | imageUrl | - |84| nano-banana | 4 | prompt | 1:1, 16:9, 9:16 |85| nano-banana-pro | 15 | prompt | same as above |86| flux-kontext-pro | 4 | prompt | same as above |87| z-image-turbo | 1 | prompt | width, height |88| imagen-4-ultra | 6 | prompt | same as above |89| image-4-fast | 3 | prompt | same as above |90| ideogram-v3-turbo | 3 | prompt | same as above |91| stable-diffusion-3-5-large | 7/img | prompt | same as above |92| seedream-4-5 | 4 | prompt | same as above |93| object-remover | 3 | image, mask | - |94| face-swap | 3 | swapImage, inputImage | - |95| image-upscaler | 1 | imageUrl, scale | - |96| photo-restoration | 4 | imageUrl | - |97| qwen-image-edit | 3 | image, prompt | - |98| qwen-image-edit-plus | 3 | image, prompt | - |99| virtual-try-on | 3 | clothImage, personImage | - |100| ai-background-generator | 5 | imageUrl | prompt |101102## Video ModelIds103104| modelId | Credits |105|---------|---------|106| openai-sora-2 | ~50+ |107| google-veo-3 | 10 |108| google-veo-3-fast | 9 |109| google-veo-3-1 | 10 |110| google-veo-3-1-fast | 9 |111| kling-2-1 | 9 |112| kling-v2-6-motion-control | 7/sec |113| minimax-hailuo-2-3 | 9 |114| minimax-hailuo-2-3-fast | 9 |115| bytedance-seedance-1-pro-fast | 8 |116| runway-gen4-turbo | varies |117| pixverse-5 | 9 |118| wan-2-5-i2v | 9 |119| wan-2-5-t2v | 9 |120| wan-2-6-i2v | 29 |121| wan-2-6-t2v | 29 |122123## OpenClaw Tools124125| Tool | Description |126|------|-------------|127| `yollomi.generate` | Generate image or video. Params: `type`, `modelId`, `prompt`, `imageUrl`, `aspectRatio`, `numOutputs`, `inputs` (video) |128| `yollomi.listModels` | List all available image and video models with credit costs. No auth required. |129130## Workflow1311321. **List models** → `yollomi.listModels()` or GET /api/v1/models1332. **Generate image** → `yollomi.generate({ type: "image", modelId, prompt, ... })`1343. **Generate video** → `yollomi.generate({ type: "video", modelId, prompt, inputs: { ... } })`1354. **401/402** → Check API key and credits136137## Reference138139Full model list and params: [models-reference.md](models-reference.md) or GET /api/v1/models
Lord1Egypt