yollomi-ai-api

name	yollomi-ai-api
description	Generate AI images and videos using Yollomi API. Use when the user wants to create images from text, remove image backgrounds, or generate AI videos. Requires YOLLOMI_API_KEY and optionally YOLLOMI_BASE_URL.

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: User must provide YOLLOMI_API_KEY (env var, .env file, or Cursor rule).
2. Base URL (optional): YOLLOMI_BASE_URL defaults to 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  \
  -H  \
  -H  \
  -d