Image to Image API

Data & APIs

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.

Install

openclaw skills install mediaio-image-to-image-api

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

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

Quick Start

1) Install Dependency

pip install requests

2) Initialize Skill

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:

$env:API_KEY="your-api-key"

macOS / Linux (bash/zsh):

export API_KEY="your-api-key"

Usage Examples (Python)

Style Transfer

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')

result = skill.invoke(
    'Seedream 4.0',
    {
        'prompt': 'transform this photo into an oil painting in the style of Van Gogh, vibrant colors, visible brushstrokes',
        'image': 'https://example.com/input-image.jpg'
    },
    api_key=api_key
)
print(result)  # Returns task_id when code=0

Artistic Enhancement

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')

result = skill.invoke(
    'Nano Banana Pro',
    {
        'prompt': 'enhance this portrait with dramatic cinematic lighting, professional photography quality, shallow depth of field',
        'image': 'https://example.com/portrait.jpg'
    },
    api_key=api_key
)
print(result)

Creative Transformation

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')

result = skill.invoke(
    'Seedream 4.0',
    {
        'prompt': 'convert this landscape into a cyberpunk cityscape at night, neon lights, rain reflections, futuristic atmosphere',
        'image': 'https://example.com/landscape.jpg',
        'ratio': '16:9'
    },
    api_key=api_key
)
print(result)

Image Remixing

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')

result = skill.invoke(
    'Nano Banana',
    {
        'prompt': 'reimagine this image as a watercolor painting, soft edges, pastel colors, artistic interpretation',
        'image': 'https://example.com/original.jpg',
        'strength': '0.7'
    },
    api_key=api_key
)
print(result)

Query Task Result

import os
import time
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')

task_id = 'your-task-id'

for _ in range(24):
    r = skill.invoke('Task Result', {'task_id': task_id}, api_key=api_key)
    print(r)
    status = (r.get('data') or {}).get('status')
    if status in ('completed', 'failed', 'succeeded'):
        break
    time.sleep(5)

Task Status Reference

waiting: queued
processing: running
completed: completed successfully
failed: failed
timeout: timed out

Model Comparison

Model	Best For	Resolution	Speed
Seedream 4.0	High quality, artistic	Up to 4K	Medium
Nano Banana Pro	Advanced reasoning, fusion	Up to 4K	Medium
Nano Banana	Fast transformations	Up to 4K	Fast
Media 2.0	Diverse styles	Standard	Fast

Common Transformations

Style Transfers

Oil painting, watercolor, pencil sketch
Anime/manga style
Pixel art, 8-bit style
Cinematic movie still

Enhancements

Professional photography quality
Dramatic lighting
Color grading
Depth of field effects

Creative Transformations

Season changes (summer to winter)
Time of day changes
Architecture style conversion
Fantasy/sci-fi conversion

Error Handling

Error Code	Description
`374004`	Not authenticated. Apply for an APP KEY at https://developer.media.io/
`490505`	Insufficient credits. Recharge before invoking generation APIs

Tips for Better Results

Use High-Quality Input: Better source images yield better transformations
Be Specific in Prompts: Describe both the transformation and desired outcome
Adjust Strength: Use lower strength (0.3-0.5) to preserve more of the original
Match Aspect Ratios: Keep output ratio similar to input for best results

External Resources

API documentation: https://platform.media.io/docs/
Product overview: https://developer.media.io/
Credit purchase: https://developer.media.io/pricing.html

Related Files

scripts/skill_router.py: core routing logic
scripts/c_api_doc_detail.json: API definitions