PNG Via HEIC API

HEICtoPNG APIは、HEIC形式の画像をPNG形式に変換するためのAPIです。iOSやmacOSデバイスで利用されるHEIC形式の画像を、より一般的なPNG形式に変換することで、ウェブやアプリケーションでの互換性を向上させます。

---

概要

このAPIは、高品質な画像変換を迅速かつ確実に行うために設計されています。以下の特徴を備えています：

• 互換性向上: HEIC形式をサポートしないプラットフォームやブラウザでも利用可能に。

• 迅速な変換: サーバー側で高速に画像変換を処理。

• 自動化対応: システムやワークフローに組み込んで効率化。

---

料金体系

• 1000アクセスごとに100円 大量の画像変換が必要なプロジェクトでもコストを抑えて利用可能です。

---

エンドポイント

https://events-front.mixeder.net/v2/convertion/heictopng/

---

利用方法

HTTPメソッド

• POST

リクエストヘッダー

ヘッダー名	説明	必須
api-key	ユーザーのAPIキー	はい

リクエストボディ

パラメーター名	タイプ	説明	必須
file	file	HEIC形式の画像ファイル	はい

レスポンス例

成功時

{
  "success": true,
  "converted_image": "data:image/png;base64,iVBORw0..."
}

フィールド名	タイプ	説明
success	boolean	成功ステータス
converted_image	string	Base64エンコードされたPNG画像

失敗時

{
  "error": "Conversion failed"
}

フィールド名	タイプ	説明
error	string	エラーメッセージ

---

利用の流れ

1. APIキーの準備 サービスから発行されたAPIキーを取得し、リクエストヘッダーに設定します。

2. HEIC画像のアップロード リクエストボディにHEIC形式の画像ファイルを添付して、エンドポイントにリクエストを送信します。

3. PNG画像の取得 レスポンスとして返されるBase64エンコードされたPNG画像を取得し、保存または表示に利用します。

4. 利用状況の確認 利用状況はAPIの請求システムで自動的に処理されます。

---

活用事例

• 写真管理システム HEIC形式で撮影された写真を自動的にPNGに変換し、Webアプリで表示可能に。

• クラウドストレージ HEIC画像をアップロード時に変換して互換性を確保。

• マルチデバイス対応 モバイル端末で撮影されたHEIC画像を変換し、デスクトップ環境での利用を可能に。

---

注意事項

1. APIキーの保護 APIキーは他人と共有しないでください。

2. ファイルサイズの制限 HEIC画像のサイズが制限を超えないよう注意してください。

---

このAPIを利用することで、効率的な画像変換プロセスを構築し、異なるフォーマット間の互換性を向上させることが可能です。

サンプルコード

---

1. PHP

<?php
// APIエンドポイントとAPIキー
$endpoint = 'https://events-front.mixeder.net/v2/convertion/heictopng/';
$apiKey = 'YOUR_API_KEY';

// 送信するファイルパス
$filePath = '/path/to/your/image.heic';

// cURLを使用してAPIにPOSTリクエストを送信
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $endpoint,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "api-key: $apiKey",
        "Content-Type: multipart/form-data"
    ],
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile($filePath)
    ]
]);

$response = curl_exec($curl);
if (curl_errno($curl)) {
    echo 'cURL Error: ' . curl_error($curl);
    exit;
}
curl_close($curl);

// レスポンスを表示
$data = json_decode($response, true);
if (isset($data['success']) && $data['success'] === true) {
    // PNG画像の保存
    file_put_contents('/path/to/output/image.png', base64_decode($data['converted_image']));
    echo "Image converted successfully.";
} else {
    echo "Error: " . ($data['error'] ?? 'Unknown error');
}

---

2. Python

import requests

# APIエンドポイントとAPIキー
url = "https://events-front.mixeder.net/v2/convertion/heictopng/"
api_key = "YOUR_API_KEY"
file_path = "path/to/your/image.heic"

# ファイルをPOSTリクエストで送信
with open(file_path, "rb") as file:
    headers = {"api-key": api_key}
    files = {"file": file}
    response = requests.post(url, headers=headers, files=files)

# レスポンスを解析
if response.status_code == 200:
    data = response.json()
    if data.get("success"):
        # PNG画像の保存
        with open("output_image.png", "wb") as output:
            output.write(base64.b64decode(data["converted_image"]))
        print("Image converted successfully.")
    else:
        print(f"Error: {data.get('error')}")
else:
    print(f"HTTP Error: {response.status_code}")

---

3. Node.js

const axios = require("axios");
const fs = require("fs");
const FormData = require("form-data");

// APIエンドポイントとAPIキー
const url = "https://events-front.mixeder.net/v2/convertion/heictopng/";
const apiKey = "YOUR_API_KEY";

// ファイルを送信
const filePath = "./path/to/your/image.heic";
const formData = new FormData();
formData.append("file", fs.createReadStream(filePath));

axios.post(url, formData, {
    headers: {
        "api-key": apiKey,
        ...formData.getHeaders()
    }
}).then(response => {
    if (response.data.success) {
        // PNG画像を保存
        const buffer = Buffer.from(response.data.converted_image, "base64");
        fs.writeFileSync("./output_image.png", buffer);
        console.log("Image converted successfully.");
    } else {
        console.error("Error:", response.data.error);
    }
}).catch(error => {
    console.error("Error:", error.message);
});

---

4. Ruby

require "net/http"
require "uri"
require "json"
require "base64"

# APIエンドポイントとAPIキー
url = URI.parse("https://events-front.mixeder.net/v2/convertion/heictopng/")
api_key = "YOUR_API_KEY"

# ファイルを読み込む
file_path = "path/to/your/image.heic"
file = File.open(file_path, "rb")

# リクエストを送信
request = Net::HTTP::Post.new(url)
request["api-key"] = api_key
form_data = [["file", file]]
request.set_form(form_data, "multipart/form-data")

response = Net::HTTP.start(url.hostname, url.port, use_ssl: true) do |http|
  http.request(request)
end

# レスポンスを解析
if response.code.to_i == 200
  data = JSON.parse(response.body)
  if data["success"]
    File.open("output_image.png", "wb") do |f|
      f.write(Base64.decode64(data["converted_image"]))
    end
    puts "Image converted successfully."
  else
    puts "Error: #{data['error']}"
  end
else
  puts "HTTP Error: #{response.code}"
end

---

5. cURL（CLI）

curl -X POST \
  -H "api-key: YOUR_API_KEY" \
  -F "file=@/path/to/your/image.heic" \
  https://events-front.mixeder.net/v2/convertion/heictopng/ -o output_image.png

---

注意点

• APIキーの管理: APIキーは安全に保管してください。外部に公開されると不正利用のリスクがあります。

• ファイルサイズ: ファイルサイズの制限(100MBまで)を確認し、それを超えないようにしてください。

• エラーハンドリング: 各サンプルコードにはエラーハンドリングを含めていますが、運用環境に合わせて最適化してください。