ForHosting KIT · PDF・文書ツール

PDFの表示が遅い

通常のPDFはファイル全体を読み込み終えるまで最初のページすら表示されません。この機能は内部構造を並べ替え、先頭ページをすぐに表示しながら残りを後ろで読み込めるようにし、Web上での体感速度を改善します。

● Beta文書あたり$0.042

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

オンラインで実行

アカウントでログインし、当社のサーバー上で実行します。無料ツールはブラウザ内で動作しますが、これは上記の料金がKIT残高から差し引かれます。

なぜ表示に時間がかかるのか

一般的なPDFはページの要素が順不同で保存されており、ブラウザはファイル全体を受け取ってから初めてページを組み立てます。40ページの資料をモバイル回線で開くと、白い画面のまま数秒待たされることも珍しくありません。内部構造を先頭ページから読める順に並べ替えると、この待ち時間が大きく短縮されます。

変わるのは順序だけ

文字も画像もレイアウトもメタデータも一切変わりません。変わるのはファイル内部にある要素の並び順だけです。読者が体感する違いは表示の速さのみで、ダウンロードしてオフラインで開く場合はほとんど差を感じません。効果が出るのは、ネットワーク越しにブラウザで直接開いたときに限られます。

圧縮とは目的が違う

ファイルサイズを小さくする圧縮とは別の処理です。この機能はサイズを変えず、ブラウザがページを読み込める順番だけを変えます。オンラインショップの商品仕様書や、自治体の申請書類のプレビューなど、PDFをダウンロードさせずに画面上で直接見せたい場面で効果を発揮します。

料金と現在の状況

1ドキュメントあたり基本料金$0.042に$0.0025が加わり、ページ数に関わらず合計$0.0445です。上限は25MB・200ページ。この機能は現在準備中で、実行はまだ受け付けていません。料金と上限はすでに確定しており、公開後も変わりません。

活用例

オンラインショップの仕様書をその場で表示

合同会社みどりデザインが運営する通販サイトで、商品ページに仕様書PDFを埋め込んでいます。先頭ページがすぐ表示される構造にしておくと、訪問者はダウンロードを待たずに内容を確認できます。

自治体の申請書をブラウザで先に見せる

ある自治体の窓口ページが、長い申請書類をダウンロード前にブラウザで確認できるようにしています。先頭ページがすぐ表示されるため、内容を見てから印刷するかどうかを判断できます。

長い報告書を記事に埋め込む

編集部が60ページの調査報告書をそのまま記事に埋め込んで公開しました。先頭ページがすぐ表示される構造のおかげで、モバイル回線の読者も白い画面で待たされません。

現場で見るカタログの表示を軽くする

株式会社山田商事が取引先向けの商品カタログをリンクで共有しています。回線が不安定な現場でも、先頭ページだけはすぐに表示されるため、確認作業が止まりません。

よくある質問

処理した後、ドキュメントの見た目は変わりますか？

変わりません。文字もレイアウトもフォントも同じで、変わるのは内部にあるページ要素の並び順だけです。

圧縮とはどう違いますか？

圧縮はファイルサイズを小さくしますが、この機能はサイズを変えず、ブラウザが先頭ページから読み込める順番に並べ替えます。

ダウンロードしてから開いた場合も効果はありますか？

効果はほとんど感じません。差が出るのは、PDFをダウンロードせずブラウザで直接開いたときです。

料金はどう計算されますか？

基本料金$0.042に$0.0025が加算され、ページ数に関わらず1ドキュメント$0.0445です。

処理したファイルはサーバーに残りますか？

残りません。処理と結果の受け渡しに使うだけで、その後は削除されます。

このページからすぐ試せますか？

まだ試せません。現在は準備段階で実行を受け付けておらず、料金と上限だけを先に公開しています。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/pdf/linearize

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

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

curl -X POST https://api.kit.forhosting.com/pdf/linearize \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"pdf":"https://ejemplo.com/documento.pdf"}'

const res = await fetch("https://api.kit.forhosting.com/pdf/linearize", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pdf": "https://ejemplo.com/documento.pdf"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/linearize",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/linearize", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"pdf":"https://ejemplo.com/documento.pdf"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/linearize", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "pdf": "https://ejemplo.com/documento.pdf"
}

レスポンス例

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

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

料金

1リクエストあたり$0.042

文書あたり$0.0025

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

制限

`max_mb`	25
`max_pages`	200

エラー

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

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