name: mediaio-text-to-image-api description: "Generate AI images from text descriptions using Media.io OpenAPI. Provide a text prompt and receive a high-quality AI-generated image. Supports multiple models including Imagen 4, Seedream, and more." metadata: {"mediaio":{"emoji":"🎨","requires":{"env":["API_KEY"]}},"publisher":"Community Maintainer","source":"https://platform.media.io/docs/","homepage":"https://developer.media.io/"}

MediaIO Text to Image API Skill

Overview

This skill provides Text-to-Image generation capabilities through the Media.io OpenAPI. Transform your text descriptions into high-quality AI-generated images using state-of-the-art models.

Trigger Keywords

Use this skill when you hear: - "text to image", "text-to-image API", "generate image from text" - "create image from text", "text to image generation" - "AI image from prompt", "generate image with text"

小葱技能7w4.net有完整的技能分类。

Supported Models

The Text-to-Image API supports multiple models: - Imagen 4 (t2i-imagen-4) - Google's photorealistic image generation - Soul Character (t2i-soul-character) - Character generation

Requirements

Environment Variables

API Details

Text-to-Image Generation

Imagen 4 (Recommended)

• API Name: Imagen 4
• Model Code: t2i-imagen-4
• Endpoint: POST https://openapi.media.io/generation/imagen/t2i-imagen-4
• Description: Sets a new standard for photorealism and text rendering accuracy.

Request Parameters

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)

Basic Text-to-Image Generation

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(
    'Imagen 4',
    {
        'prompt': 'a serene mountain landscape at sunset, photorealistic, golden hour lighting',
        'ratio': '16:9',
        'counts': '1'
    },
    api_key=api_key
)
print(result)  # Returns task_id when code=0

Artistic Style Generation

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(
    'Imagen 4',
    {
        'prompt': 'an oil painting of a bustling Parisian cafe in the style of Impressionism, warm colors, visible brushstrokes',
        'ratio': '4:3'
    },
    api_key=api_key
)
print(result)

Character Generation

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(
    'Soul Character',
    {
        'prompt': 'a friendly fantasy wizard with a long white beard and blue robes, detailed character design',
        'ratio': '1:1'
    },
    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

Supported Aspect Ratios

Error Handling

Tips for Better Results

1. Be Specific: Include details about lighting, style, and mood
2. Use Descriptive Adjectives: "photorealistic", "cinematic", "vibrant"
3. Specify Art Styles: "in the style of Van Gogh", "anime style", "watercolor"
4. Include Technical Details: "8K", "HDR", "depth of field"

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

质量较好，文档清晰易懂，代码结构规范。支持 Imagen 4 和 Soul Character 两种文生图模型，示例丰富，涵盖常见使用场景。代码实现了安全校验和异常处理，能有效防止无效请求。不足之处是缺少使用限制说明和更详细的故障排查指引。总体而言，这是一个可靠且易用的文生图 API Skill，适合需要快速集成 Media.io 图像生成能力的开发者。