メインコンテンツへスキップ
PDF4me API統合AIとSDK知識ベース拡張機能APIテスターブログ

テキストを画像に置き換える - 画像置換 API

PDF4me テキストを画像に置き換える 高度なページフィルタリングとサイズ制御オプションを使用して、Word 文書内の指定したテキストを画像に置き換えることができます。 API このサービスは、Word ファイルを処理し、正確なテキストマッチング、アスペクト比を維持したカスタマイズ可能なサイズ設定、ページ固有のターゲティング、柔軟なフィルタリングオプションを使用して、テキストプレースホルダーを画像に置き換えます。 API Word文書の内容と画像データを以下の方法で受信します。 REST API 通話を利用して Base64 安全な送信のためのエンコード機能。複数の画像フォーマットに対応し、置換動作を完全に制御できるため、文書自動化、テンプレート処理、動的コンテンツ挿入ワークフローに最適です。

関連ブログ記事
この機能に関するブログ記事はまだありません。近日公開予定です。
その間、PDF4me ブログを閲覧して、あらゆるプラットフォームのチュートリアルやワークフローをご覧ください。
ブログをご覧ください →

認証 API リクエスト​

アクセスするには PDF4me REST APIすべてのリクエストには適切な認証情報を含める必要があります。認証により安全な通信が保証され、あなたが正規のユーザーであることが検証されます。 REST API。

Get your api Key

主な機能​

  • テキストから画像への置換: 文書全体で特定のテキスト文字列を画像に置き換える
  • 正確なテキストマッチング大文字と小文字を区別するテキスト検索と置換
  • 画像サイズコントロール: 幅と高さのパラメータを使用して画像のサイズをカスタマイズします
  • アスペクト比の維持: サイズ変更時に画像の縦横比を維持する
  • ページフィルタリング置換対象となる特定のページまたはページ範囲を指定します。
  • 高度なフィルタリング最初のページをスキップする、奇数ページまたは偶数ページを対象とする、または正確なページ番号を指定する
  • 複数の画像フォーマット: サポート PNG、 JPG、 JPEG、 BMP、 GIF フォーマット
  • 柔軟な位置決め: 画像をWordの図形として正確な位置に挿入します

REST API 終点​

の PDF4me REST API 標準を使用する HTTP リソースとやり取りするためのメソッド。すべてのテキストから画像への置換操作は、単一のエンドポイントを介して実行されます。

  • 方法： POST
  • 終点： office/ApiV2Word/ReplaceTextWithImage

REST API パラメータ​

テキストを画像に置き換えるためのパラメータの完全なリスト REST APIパラメータは、理解と実装を容易にするためにカテゴリ別に整理されています。

重要： アスタリスク（*）が付いているパラメータは必須項目です。詳細設定パラメータを使用すると、画像サイズやページフィルタリングを細かく制御できます。

パラメータ必須その機能例
documentRequiredSource file. `Name` must end in `.docx` or `.doc`.{ "Name": "document.docx" }
document.NameRequiredFile name including its extension. Type: string.{ "Name": "document.docx" }
docContentRequiredThe source file, base64-encoded. Type: string.base64EncodedDocumentContent
isAsyncOptionalProcess the request in the background. The call returns `202 Accepted`; poll the `Location` URL (`GetActionStatus`) for the result. Type: boolean.
findTextRequiredThe text to replace. Not case-sensitive. Type: string."text to replace"
imageContentRequiredThe image, base64-encoded. Type: string.base64EncodedImageContent
widthOptionalImage width in points. Defaults to the image size. Type: number.200
heightOptionalImage height in points. Defaults to the image size. Type: number.100
maintainAspectRatioOptionalKeep the image's proportions; `width` takes priority. Type: boolean.true
applyToOptionalWhich matching pages to replace on. Type: string.
pageNumbersOptionalOnly replace on these pages, e.g. `"1,3,5-7"`. Type: string."1,2,3"
ignorePageNumbersOptionalNever replace on these pages, e.g. `"2,4"`. Type: string.
skipFirstPageOptionalNever replace on page 1. Type: boolean.false

ページフィルタリング​

の API 以下のパラメータによるページフィルタリングをサポートしています。

  • skipFirstPage最初のページをスキップするかどうかを制御します
  • ページ番号: 処理するページを指定します（空文字列はすべてのページを意味します）
  • ページ番号を無視する除外するページ番号

対応画像フォーマット​

テキストを画像に置き換える API 最大限の互換性を実現するために、さまざまな画像フォーマットをサポートしています。

形式拡大説明
PNG.pngポータブルネットワークグラフィックス - ロゴや透明度のあるグラフィックに最適
JPEG.jpg、.jpeg合同写真専門家グループ - 写真や複雑な画像に最適
BMP.bmpビットマップ - 非圧縮形式、ファイルサイズが大きい
GIF.gifグラフィックス交換フォーマット - アニメーションと透明度をサポート

出力​

の PDF4me テキストを画像に置き換える REST API を返します JSON 応答 （ApiV2WordApiCallRes) 成功した場合、 API Word文書をとして返します Base64エンコードされた文字列 で document バイナリデータではなく、フィールドとして扱われます。

成功時の対応

ステータスコード: 200 OK

コンテンツタイプ: application/json

応答本文：

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "document.docx",
"success": true,
"errorMessage": null
}

回答欄:

  • 書類 （string): テキストが画像に置き換えられた Word 文書、エンコード形式は Base64
  • ファイル名 （string出力Wordファイル名
  • 成功 （boolean手術が成功したかどうか
  • エラーメッセージ （string): 成功が偽の場合はエラーメッセージ。それ以外の場合は null

使用方法：

  1. チェック success; 真であれば、抽出します document からのフィールド JSON 応答
  2. 解読する Base64 バイナリ形式のWord文書データを取得する文字列
  3. Word ファイルを保存または処理するには、 fileName

例（JavaScript）：

const response = await fetch(url, options);
const data = await response.json();
if (!data.success) throw new Error(data.errorMessage);
const wordBytes = atob(data.document);
// Save or process wordBytes

リクエスト例​

ヘッダ​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

注記：

  • 手に入れよう API 鍵から PDF4me ダッシュボード
  • の API キーは Base64 エンコードされ、「Basic」がプレフィックスとして付加されています。 Authorization ヘッダー
  • 例: API 重要なのは abc123エンコードして Base64 そして使用する Authorization: Basic YWJjMTIz

ペイロード​

基本的な例（必須項目のみ）：

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "findText": "text to replace",
 "imageContent": "base64EncodedImageContent",
 "cultureName": "en-US"
}

高度な例（オプションフィールド付き）：

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "findText": "text to replace",
 "imageContent": "base64EncodedImageContent",
 "width": 200,
 "height": 100,
 "maintainAspectRatio": true,
 "skipFirstPage": true,
 "pageNumbers": "1,2,3",
 "ignorePageNumbers": null,
 "cultureName": "en-US"
}

コードサンプル​

の PDF4me テキストを画像に置き換える REST API 複数のプログラミング言語のコードサンプルを提供します。開発環境に最適な言語を選択してください。

C# （CSharpサンプル

完了 C# Word文書内のテキストを画像に置き換えるための実装例：

業界におけるユースケースとアプリケーション​

法律・専門サービスにおけるユースケース

  • 契約処理署名プレースホルダーを承認済みの署名に置き換えてください。
  • 法律文書の自動化法的文書に企業のロゴと透かしを挿入する
  • クライアント文書のパーソナライゼーション: 法的文書に顧客固有の画像を追加する
  • コンプライアンス文書書類にコンプライアンススタンプとシールを挿入する

ヘルプが必要な場合​

Get Your API KeyAPI SamplesGetting Started