mediaio-image-to-image-api

by wondershare-boop

Install this Skill

curl -fsSL -o mediaio-image-to-image-api.zip https://skill.seembox.com/api/v1/skills/mediaio-image-to-image-api/download && unzip mediaio-image-to-image-api.zip

Download mediaio-image-to-image-api.zip

SKILL.md About

---
name: mediaio-image-to-image-api
description: "Transform existing images into new ones using AI via Media.io OpenAPI. Apply style transfers, artistic filters, and creative transformations with models like Seedream, Nano Banana, and more."
metadata: {"mediaio":{"emoji":"🎨","requires":{"env":["API_KEY"]}},"publisher":"Community Maintainer","source":"https://platform.media.io/docs/","homepage":"https://developer.media.io/"}
---

# MediaIO Image to Image API Skill

## Overview
This skill provides **Image-to-Image** transformation capabilities through the Media.io OpenAPI. Transform your existing images into new creations using state-of-the-art AI models for style transfers, artistic filters, and creative transformations.

## Trigger Keywords
Use this skill when you hear:
- "image to image", "image-to-image API", "transform image"
- "style transfer", "image transformation", "edit image with AI"
- "apply artistic filter to image", "image remixing"

## Supported Models
The Image-to-Image API supports multiple models:
- **Seedream 4.0** (`i2i-seedream-v4-0`) - High aesthetic quality, 4K support, character consistency
- **Nano Banana Pro** (`i2i-banana-2`) - Advanced reasoning, multi-image fusion
- **Nano Banana** (`i2i-banana`) - Fast and efficient generation
- **Media 2.0** (`i2i-media-2.0`) - Proprietary native model

## Requirements

### Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `API_KEY` | **Yes** | Media.io OpenAPI key, sent as `X-API-KEY` header. Apply at <https://developer.media.io/>. |

## API Details

### Image-to-Image Transformation

#### Seedream 4.0 (Recommended for Quality)

- **API Name**: `Seedream 4.0`
- **Model Code**: `i2i-seedream-v4-0`
- **Endpoint**: `POST https://openapi.media.io/generation/seedream/i2i-seedream-v4-0`
- **Description**: A versatile powerhouse supporting 4K generation and advanced editing.

#### Request Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prompt` | string | **Yes** | Text description for transformation |
| `image` | string | **Yes** | Reference image URL for transformation |
| `ratio` | string | No | Image aspect ratio |
| `strength` | string | No | How strongly to follow the reference image (0.0-1.0) |

#### Common Response Structure

```json
{
  "code": 0,
  "msg": "",
  "data": {
    "task_id": "..."
  },
  "trace_id": "..."
}
```

## Quick Start

### 1) Install Dependency
```bash
pip install requests
```

### 2) Initialize Skill
```python
import os
from scripts.skill_router import Skill

skill = Skill('scripts/c_api_doc_detail.json')
api_key = os.getenv('API_KEY', '')
if not api_key:
    raise RuntimeError('API_KEY is not set')
```

### 3) Configure Environment Variable API_KEY

**Windows PowerShell**:
```powershell
$env:API_KEY="your-api-key"
```

**macOS / Linux (bash/zsh)**:
```bash
export API_KEY="your-api-key"
```

## Usage Examples (Python)

### Style Transfer
```python
import os
from scripts.skill_router import Skill