Yollomi AI API Skill

Generates images and videos via the Yollomi API. All models use a single unified endpoint with different modelId parameters.

Setup

1. API Key: Set YOLLOMI_API_KEY (environment variable).
2. 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:

Image ModelIds

Video ModelIds

OpenClaw Tools

Workflow

1. List models → yollomi.listModels() or GET /api/v1/models
2. Generate image → yollomi.generate({ type: "image", modelId, prompt, ... })
3. Generate video → yollomi.generate({ type: "video", modelId, prompt, inputs: { ... } })
4. 401/402 → Check API key and credits

Reference

Full model list and params: models-reference.md or GET /api/v1/models