ForHosting KIT · 画像の編集・解析

画像を角度指定で回転

画像の角度指定回転では、長方形の画像を回転した後に全体を収めるために必要なピクセル寸法を計算します。元の幅、高さ、時計回りの角度をご入力ください。初期設定では90度の倍数を受け付け、寸法をそのまま、または正確に入れ替えて返します。任意の有限角度を使う場合は自由回転を有効にすると、回転した長方形を含む最小の整数ピクセルの外接枠が得られます。計算するのは幾何情報だけであり、画像のアップロード、解析、保存、変更は行いません。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

90度単位の回転枠を計算する方法

元画像の幅と高さを正の整数ピクセルで指定し、その後に回転角度をご入力ください。初期設定では、角度は90度の倍数である必要があります。0度または180度では寸法の並びが変わらず、90度または270度では幅と高さが入れ替わります。角度は0度以上360度未満の同じ向きへ正規化されるため、負の角度や1回転を超える値にも同じ規則が適用されます。たとえば、1920×1080ピクセルの画像を90度回転すると1080×1920の枠になり、450度でも同じ結果になります。90度単位の処理には三角関数ではなく正確な整数判定を使用するため、直角付近で小さな浮動小数点誤差が生じません。返される値は回転後の長方形を収めるキャンバスの寸法です。画像を拡大縮小した寸法ではなく、この機能が画像を回転、送信、解析、変更することもありません。

任意角度では自由回転を有効にします

角度が90度の倍数でない場合は、free_rotate を true に設定してください。計算では元画像を回転軸の中心に置いた長方形として扱い、回転後の各頂点を囲む最小の軸平行な外接枠を求めます。幅には元の幅と高さが持つ水平方向の絶対成分を使い、高さには対応する垂直方向の成分を使います。実数の計算結果がピクセルの間に位置することがあるため、各辺は次の整数ピクセルへ切り上げます。この切り上げは意図的です。四捨五入ではキャンバスが小さくなり、外縁や角が欠ける可能性があります。正方形は45度付近で通常より大きな枠を必要とし、横長画像はわずかな傾きでも高さが大きく増える場合があります。角度は時計回りを基準としますが、同じ傾き量の正角と負角では、正弦と余弦の絶対値が等しいため外接寸法も同じになります。

画像処理で結果を安全に利用できます

返された幅と高さは、出力キャンバスの作成、レイアウト領域の確保、メモリ見積もり、後続の画像処理コマンドの設定にお使いいただけます。この計算は長方形の中心を軸とした回転と、軸に平行な出力キャンバスを前提とします。別のツールが角を中心に回転したり、遠近変形、透明ピクセルの切り詰め、枠線、独自の余白を適用したりする場合、最終寸法は異なることがあります。元寸法には10億ピクセル以下の正の整数を指定し、角度には有限数をご使用ください。free_rotate は "true" という文字列ではなく、真偽値でなければなりません。不正な値は暗黙変換せず拒否するため、自動処理でも結果を予測できます。ネットワーク、乱数、現在時刻、ファイル解析、隠れた状態は使用せず、同じ入力には常に同じ出力を返します。API による自動化は1回 $0.002 です。

活用例

回転用キャンバスを準備

回転した画像のすべての角を欠けずに収められる出力キャンバスを確保できます。

レスポンシブ配置を設計

ページやアプリに回転画像を表示する前に、正確な幅と高さの領域を予約できます。

画像処理コマンドを作成

回転設定を画像ライブラリやサービスへ渡す前に、出力先の寸法を算出できます。

よくある質問

この機能で画像そのものを回転できますか？

いいえ。外接枠の寸法だけを計算し、画像ピクセルの受信や変更は行いません。

初期設定で直角以外が拒否されるのはなぜですか？

90度単位の正確な寸法を前提とする処理を守るためです。任意の有限角度では free_rotate を有効にしてください。

小数になる外接寸法はどう処理されますか？

回転した長方形が欠けないように、各辺を次の整数ピクセルへ切り上げます。

負の角度や360度を超える角度も使えますか？

はい。角度は1回転内の同じ向きへ正規化されます。

API リクエストの料金はいくらですか？

API リクエスト1回の料金は $0.002 です。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/image/rotate-degrees

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/image/rotate-degrees \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1920,"height":1080,"angle":90}'

const res = await fetch("https://api.kit.forhosting.com/image/rotate-degrees", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "width": 1920,
    "height": 1080,
    "angle": 90
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/rotate-degrees",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "width": 1920,
    "height": 1080,
    "angle": 90
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/rotate-degrees", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"width":1920,"height":1080,"angle":90}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"width":1920,"height":1080,"angle":90}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/rotate-degrees", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "width": 1920,
  "height": 1080,
  "angle": 90
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.rotate_degrees",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

`max_mb`	15
`max_megapixels`	12

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →