ForHosting KIT · 画像の編集・解析

画像のトリミング範囲を確認

画像の切り抜き計算は単純に見えますが、自動処理へ渡された座標が元画像から1ピクセルだけはみ出すことがあります。この検証ツールは、元画像の幅と高さ、および x、y、幅、高さで表した切り抜き枠を受け取ります。各値を確認し、長方形全体が画像内に収まる場合に切り抜き後の寸法を返します。画像のアップロードやデコードは不要です。そのため、画像処理の実行前、切り抜きプレビューの作成時、別サービスから座標を受け取る際の事前確認にご利用いただけます。

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

無料で実行 API仕様を見る

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

元画像と切り抜き枠を指定します

最初に元画像のピクセル寸法を指定してください。image_width には横方向の総ピクセル数、image_height には縦方向の総ピクセル数を入力します。次に、x、y、width、height で長方形を表します。x と y は、座標 0,0 である画像左上を基準に、枠の左上位置を示します。Width は右方向、height は下方向へ伸びます。この機能は小数の図形ではなく、ピクセルにそろったラスター画像の切り抜きを扱うため、6個の値はすべて整数でなければなりません。画像と切り抜き枠の寸法は正数が必要ですが、x と y にはゼロを指定できます。たとえば x が 240 なら、先頭の 240 ピクセル列を飛ばして切り抜きを開始します。枠は画像のどの辺にもぴったり接することができます。そのため、x と width の和は image_width と等しくてもよく、y と height の和も image_height と等しくて構いません。実際に処理する画像の寸法を使用し、縮小プレビューの座標は元画像の倍率へ戻してから送信してください。

境界の検証方法を確認します

まず、値の欠落、整数以外の数値、負の座標、面積がない枠、仕様範囲外の値を拒否します。続いて、長方形が完全に含まれるかを2方向で確認します。横方向では x と width の和が image_width 以下、縦方向では y と height の和が image_height 以下である必要があります。どちらかの和が大きい場合は、要求した範囲の一部が元画像の外へ出るため、無効な入力としてエラーを返します。この明確な条件により、1単位ずれる典型的な誤解を防げます。x 0 から始まる幅 100 ピクセルの枠は、100 ピクセル分を占めるため、幅 100 ピクセルの画像に正確に収まります。無効な枠を自動で制限、移動、縮小することはありません。座標を黙って変えると、意図しない被写体や構図になるおそれがあるためです。画像データ自体も解析しません。判定は指定された寸法と座標だけで決まり、高速かつ再現可能で、対話フォームと自動処理の両方に適しています。

実際の切り抜き前に結果を使います

検証に成功すると、完成する切り抜きの幅と高さを返します。この機能は長方形の形を変えたり再サンプリングしたりせず、幾何情報だけを確認するため、結果は指定した枠の寸法と一致します。同じ座標を画像処理ライブラリ、メディアサービス、レンダリングキューへ渡す前の防護としてお使いください。低コストの入力検証を高コストな画像デコードから分離でき、予測可能な境界エラーが後続処理へ届くのを防げます。編集画面では、利用者が選択を確定した後、またはプレビュー座標を元画像のピクセルへ変換した後に検証します。データ処理では、切り抜きメタデータの受信直後に確認し、不正なレコードを修正工程へ送ります。別工程で画像を物理的に回転する場合は、回転後の寸法と同じ向きの座標をご利用ください。API リクエストは $0.002 です。ブラウザー版も同一の決定的計算をローカルで実行し、どちらも画像を送信しません。

活用例

画像処理キューを保護します

ワーカーが元画像を取得してデコードする前に、境界外のメタデータを拒否できます。

編集画面の選択を検証します

プレビューから変換した座標が元画像の寸法内に収まるか確認できます。

取り込んだメタデータを点検します

保存済みの長方形を監査し、関連画像へ適用できないレコードを特定できます。

よくある質問

画像の切り抜きやアップロードも行いますか？

いいえ。数値の寸法と座標だけを検証し、切り抜いた場合のサイズを返します。

枠が右端または下端に接しても有効ですか？

はい。x と width の和が image_width、または y と height の和が image_height と等しくても有効です。

小数の座標を指定できますか？

いいえ。ピクセルに合わせるため、すべての寸法と座標は整数で指定してください。

境界外の枠は自動調整されますか？

いいえ。要求した枠を変更せず、無効な入力としてエラーを返します。

API の利用料金はいくらですか？

API リクエスト1回につき $0.002 です。同じ決定的な検証をブラウザーでもご利用いただけます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/image/crop-to-box

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

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

curl -X POST https://api.kit.forhosting.com/image/crop-to-box \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_width":1920,"image_height":1080,"x":240,"y":120,"width":800,"height":600}'

const res = await fetch("https://api.kit.forhosting.com/image/crop-to-box", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "image_width": 1920,
    "image_height": 1080,
    "x": 240,
    "y": 120,
    "width": 800,
    "height": 600
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/crop-to-box",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "image_width": 1920,
    "image_height": 1080,
    "x": 240,
    "y": 120,
    "width": 800,
    "height": 600
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/crop-to-box", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"image_width":1920,"image_height":1080,"x":240,"y":120,"width":800,"height":600}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"image_width":1920,"image_height":1080,"x":240,"y":120,"width":800,"height":600}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/crop-to-box", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "image_width": 1920,
  "image_height": 1080,
  "x": 240,
  "y": 120,
  "width": 800,
  "height": 600
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.crop_to_box",
  "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の完全なドキュメントを見る →