yollomi-ai-api

# 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).

Notes:
- Video generation is temporarily disabled in this skill build.

## 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)**:
```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"}'
```

**Remove background**:
```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"}'
```

**Generate video**:
```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"}'
```

## 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 |...

# Yollomi AI Image Generator (All Models)

An AI image generator skill for OpenClaw. Image generation for text-to-image and image-to-image, across many AI image models via one unified Yollomi API.

Keywords: image, ai image, image generator, image generation, text-to-image, image-to-image, multimodel.

> Note: Video generation is temporarily disabled in this build.

## Install (ClawHub)

```bash
clawhub install yollomi
```

## Configuration

Set the following environment variable for OpenClaw:

- `YOLLOMI_API_KEY` (required)

## Usage

Ask the agent to generate an image. The skill uses the unified endpoint:

`POST /api/v1/generate` with `{ type: "image", modelId, ... }`

See [SKILL.md](SKILL.md) and [models-reference.md](models-reference.md) for modelIds and parameters.