Text to Image API

👤 wondershare-boop 📦 v1.0.2 ⭐ 4.3 ⬇️ 708 下載
🎨 設計多媒體 免費 🔑 需 API Key

📖 技能介紹

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"

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

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

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.

    小蔥技能站7w4.net發現了升級外掛。

Request Parameters

Parameter Type Required Description
prompt string Yes Text description for image generation
ratio string No Image aspect ratio (e.g., "1:1", "16:9", "9:16")
counts string No Number of images to generate (default: "1")

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

Ratio Dimensions Use Case
1:1 Square Profile pictures, thumbnails
16:9 Landscape Wallpapers, banners
9:16 Portrait Mobile wallpapers, stories
4:3 Standard Traditional photos
3:4 Portrait Traditional portraits

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

  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

Related Files

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

🤖 AI 評測

質量較好,文件清晰易懂,程式碼結構規範。支援 Imagen 4 和 Soul Character 兩種文生圖模型,示例豐富,涵蓋常見使用場景。程式碼實現了安全校驗和異常處理,能有效防止無效請求。不足之處是缺少使用限制說明和更詳細的故障排查指引。總體而言,這是一個可靠且易用的文生圖 API Skill,適合需要快速整合 Media.io 影像生成能力的開發者。

📊 多維度評分

適應性4.3
規範性4.3
有效性4.4
可靠性4.2
可信度4.7

📁 包含檔案 (4 個)

📄 SKILL.md 6 KB
📄 _meta.json 144 B
📄 scripts/c_api_doc_detail.json 12 KB
📄 scripts/skill_router.py 3.1 KB