upscale-image は何をしますか？
Pilio開発者APIを使用して画像をアップスケールまたは強化します。ユーザーが高解像度画像、AI超解像、画像の鮮明化、Pilioによる自動画像強調を希望する場合に使用します。
概要
このスキルは、Pilioの画像処理APIを介して画像をアップスケールおよび強化するためのツールです。以下の機能をサポートします：
- 画像のアップスケール: 画像を指定された倍率で拡大します。
- AI超解像: AIを使用して画像の解像度を向上させ、詳細を復元します。
- 画像の鮮明化: ぼやけを低減し、全体的な鮮明度を向上させます。
- 自動画像強調: コントラスト、色、シャープネスを自動調整します。
使用方法
前提条件
- Pilio APIキーが必要です。
PILIO_API_KEY環境変数として設定するか、関数呼び出し時に直接渡します。
基本使用法
const result = await upscaleImage({
apiKey: 'your-pilio-api-key',
imageUrl: 'https://example.com/image.jpg',
scale: 2, // 1倍から4倍まで対応
enhance: true // 追加の強調処理を有効化
});
パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
apiKey | string | いいえ（環境変数推奨） | Pilio APIキー |
imageUrl | string | はい | 処理する画像のURL |
scale | number | いいえ（デフォルト: 2） | アップスケール倍率（1-4） |
enhance | boolean | いいえ（デフォルト: false） | AIによる画像強調を有効化 |
応答
{
"success": true,
"data": {
"imageUrl": "https://cdn.pilio.ai/processed/abc123.jpg",
"originalSize": { "width": 800, "height": 600 },
"processedSize": { "width": 1600, "height": 1200 },
"scale": 2
}
}
制限事項
- 最大入力画像サイズ: 10MB
- 対応フォーマット: JPEG, PNG, WebP, BMP, TIFF
- 1リクエストあたりの最大アップスケール倍率: 4倍
- APIレート制限が適用される場合があります（プランにより異なる）
エラーハンドリング
このスキルは、無効なパラメータやAPIエラーに対して明確なエラーメッセージを返します。例：
INVALID_IMAGE_URL: 提供されたURLが画像を指していないか、アクセスできません。IMAGE_TOO_LARGE: 画像が10MBの制限を超えています。UPSCALE_FAILED: 内部エラーによりアップスケール処理に失敗しました。
ベストプラクティス
- 可能な限り、APIキーを環境変数として設定し、コード内にハードコードしないでください。
- 大きな画像は事前に圧縮してAPI制限に引っかからないようにしてください。
- 最適な結果を得るには、
enhance: trueを併用することをお勧めします。
サポート
問題が発生した場合や質問がある場合は、Pilioサポートまでお問い合わせいただくか、Pilioドキュメント（https://docs.pilio.ai）をご参照ください。