ForHosting KIT · 開発者向けツール

CMYKの下色除去（UCR）計算ツール

この下色除去計算ツールは、シアン、マゼンタ、イエローに共通するニュートラル成分を求め、その重なりから指定割合を除き、CMYKの有効範囲内で同量の黒を加えて1つのCMYKカラーを変換します。調整後の各チャンネルに加え、処理前後の総インキ量も表示します。すべての割合を検証する確定的な計算であり、印刷工程へ結果を渡す前にインキ削減効果を明確に確認できます。

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

無料で実行 API仕様を見る

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

下色除去によって変わる内容

一般にUCRと略される下色除去は、シアン、マゼンタ、イエローのインキが重なって作るニュートラル部分を減らし、その部分を黒に置き換える処理です。濃いグレーやシャドーなどのCMYKカラーでは、3色を組み合わせた視覚的な役割の多くがニュートラル濃度であっても、各有彩色インキが相当量含まれることがあります。この計算ツールでは、3つのCMY比率の最小値を除去可能なニュートラル成分とします。そのため、処理によっていずれかのチャンネルがゼロ未満になることはありません。指定したUCR比率により、共通成分から取り除く量が決まります。ゼロでは色を変更せず、百では利用可能な重なりをすべて除去します。計算した同じ量を既存の黒チャンネルへ追加しますが、有効な最大黒濃度を超えることはありません。3チャンネルの寄与を減らし、追加するのは最大でも1チャンネルなので、表示される総インキ量は低下します。この結果はインキ分版の数学的な調整値であり、特定の印刷機、用紙、プロファイル、インキセットでの正確な印刷外観を予測するものではありません。

CMYK値の入力方法と結果の読み方

シアン、マゼンタ、イエロー、黒を、ゼロから百までの割合で入力してください。これらの値は、UCRを適用する前の単一のCMYKカラーを表す必要があります。共通するCMY成分のうち黒に置き換えたい割合をUCR比率に指定します。中程度の設定では有彩色インキを多く残し、強い設定ではニュートラル濃度をより多く黒へ移します。出力には調整後のCMYKチャンネルのほか、ニュートラル成分、各CMYチャンネルから除いた量、黒へ実際に追加した量が示されます。入力時の黒チャンネルが上限に近い場合、最後の2つの値は異なることがあります。黒は百で上限となりますが、指定されたCMY削減は続くため、総インキ量がさらに大きく減少します。処理前後の総インキ量は、それぞれ4チャンネルの割合を合計した値であり、印刷制作では総面積率とも呼ばれます。精度オプションが制御するのは表示上の丸めだけです。UCR計算そのものを変えたり、検証範囲外の値を許可したりするものではありません。

印刷工程での結果の利用方法

この結果は、確定的な計画値、比較ツール、または自動化されたカラーパイプラインの構成要素として利用できます。同じ元色に対してUCRの強さを変えたとき、総インキ量がどのように変化するかを評価する用途に特に適しています。CMYK入力を同一に保ち、UCR比率だけを変えた複数のリクエストを比較すると、その効果を明確に確認できます。調整値を実際の制作に採用する前に、出力先ICCプロファイル、印刷方式、基材の特性、乾燥限界、印刷会社が推奨する分版方針と照合してください。実際のカラーマネジメントでは、より複雑な墨版生成カーブ、グレー成分置換、ドットゲイン補正、機器固有の総面積率制限を使用する場合があります。この計算ツールはそれらの仕組みを模擬せず、測色的な同等性も保証しません。目的は限定的かつ再現可能です。重なったCMYチャンネルから同量を除き、有効上限を超えない範囲で黒を加え、得られたインキ削減量を表示します。自動処理では、APIが処理した各カラー項目について名前付き数値フィールドを1回$0.002で返します。

活用例

UCR強度の比較

同じCMYKカラーを複数のUCR比率で処理し、得られたチャンネル値と総インキ削減量を比較できます。

濃色の事前確認

機器固有の制作ルールを適用する前に、ニュートラルなCMYの重なりを黒へ置き換えた場合の総面積率を見積もれます。

分版計算の自動化

文書化された確定的なUCRルールを個々のCMYK値へ適用し、再現可能な処理工程を構築できます。

よくある質問

APIでこの計算ツールを使う料金はいくらですか？

APIリクエスト1回の料金は$0.002です。同じ確定的な計算をブラウザーでは無料で利用できます。

除去可能なニュートラル成分はどのように計算しますか？

シアン、マゼンタ、イエローの割合のうち最小の値です。その量は3チャンネルすべてに含まれ、負の値を生じさせずに均等に除去できるためです。

総インキ量が減少するのはなぜですか？

計算した量を3つのCMYチャンネルから除き、追加するのは最大でも1つの黒チャンネルだけなので、4チャンネルの合計が減少します。

黒がすでに100パーセント近い場合はどうなりますか？

黒の追加は100パーセントで止まります。指定されたCMY除去は続き、出力には実際に黒へ追加できた少ない量が示されます。

結果によって同じ印刷外観が保証されますか？

いいえ。外観は出力プロファイル、印刷機、インキ、基材、ドットゲイン、分版方式に左右されます。結果は確定的なUCR算術調整値です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/color/ucr

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

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

curl -X POST https://api.kit.forhosting.com/color/ucr \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cyan":72,"magenta":64,"yellow":52,"black":18}'

const res = await fetch("https://api.kit.forhosting.com/color/ucr", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "cyan": 72,
    "magenta": 64,
    "yellow": 52,
    "black": 18
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/color/ucr",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "cyan": 72,
    "magenta": 64,
    "yellow": 52,
    "black": 18
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/ucr", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"cyan":72,"magenta":64,"yellow":52,"black":18}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"cyan":72,"magenta":64,"yellow":52,"black":18}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/ucr", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "cyan": 72,
  "magenta": 64,
  "yellow": 52,
  "black": 18
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

エラー

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

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