Logo FileConvertFree
✨ これらの新しいAIツールも試してみてください
• PDF to Word → | Image to Text →
FileConvertFree 開発者プラットフォーム

アプリにファイル変換を組み込む

FileConvertFree REST APIをアプリ、バックエンド、自動化、社内ワークフロー、業務システムから利用できます。

API v1: ドキュメントは公開されています。APIリクエストには有効なPremiumまたはProプランが必要です。
ダッシュボードを開く プランを見る 対話型APIドキュメント
ベースURL
REST API v1
https://fileconvertfree.com/api1
認証
X-API-Key header
X-API-Key: fcf_live_••••••••

クイックスタート

FileConvertFreeアカウントにログインします。
有効なPremiumまたはProプランを利用します。
ダッシュボード → 開発者API → APIキーを作成、の順に開きます。完全なキーは一度だけ表示されるため、すぐに安全な場所へ保存してください。
保護された各APIリクエストでX-API-Keyヘッダーにキーを送信します。

APIプランと制限

制限は同一APIアカウントのすべてのキーで共有されます。キーを追加してもクォータは増えません。

Premium

200 / day
  • 200 1日あたりのリクエスト
  • 30 1分あたりのリクエスト
  • 200 MB 最大ファイルサイズ
  • 3 有効なキー max

Pro

400 / day
  • 400 1日あたりのリクエスト
  • 60 1分あたりのリクエスト
  • 200 MB 最大ファイルサイズ
  • 3 有効なキー max

APIキー管理

1. キーを作成

ダッシュボードの開発者APIセクションから、最大3個の有効なAPIキーを保持できます。Production、Office App、Stagingなど用途が分かる名前を付けてください。

2. 作成時に保存

完全なシークレットは作成または再生成の直後にのみ表示されます。FileConvertFreeは平文のシークレットではなく安全なハッシュを保存するため、後から完全なキーを再表示することはできません。

3. キーを再生成

再生成すると新しいシークレットが作られ、古いキーは直ちに無効になります。1回だけ表示される新しいシークレットを閉じる前にアプリ側の設定を更新してください。

4. キーを無効化

不要になったキーや漏えいの可能性があるキーは無効化してください。認証には直ちに使えなくなり、無効化されたキーの記録は7日後に自動削除されます。

セキュリティルール

APIキーを共有したり、GitHubなどの公開リポジトリへ掲載したり、ブラウザ側JavaScriptへ埋め込んだり、スクリーンショットで送ったりしないでください。サーバーの環境変数やシークレット管理サービスで保管し、漏えいの可能性がある場合は直ちに再生成または無効化してください。

利用可能なエンドポイント

メソッドエンドポイント用途 / オプション
GET/v1/account/usage認証済みプラン、キー状態、1日の使用量、残りクォータ、レート制限の使用状況を取得します。
GET/healthAPIの状態とバージョンを確認する公開ヘルスチェックです。
POST/v1/pdf/to-word有効なPDFファイルをWordへ変換します。
POST/v1/pdf/to-excel有効なPDFファイルをExcelへ変換します。
POST/v1/image/to-text画像からOCRでテキストを抽出します。任意のmultipartフィールド: fast=true|false。
POST/v1/image/to-word画像をWordへ変換します。任意のmultipartフィールド: fast=true|false。
POST/v1/image/to-excel画像をExcelへ変換します。任意のmultipartフィールド: fast=true|false。
POST/v1/image/remove-background画像の背景を削除します。任意のフィールド: format（既定png）、transparent=true|false、fast_mode=true|false。

コード例

import os import requests API_KEY = os.environ["FCF_API_KEY"] url = "https://fileconvertfree.com/api1/v1/pdf/to-word" with open("sample.pdf", "rb") as source: response = requests.post( url, headers={"X-API-Key": API_KEY}, files={"file": ("sample.pdf", source, "application/pdf")}, timeout=700, ) response.raise_for_status() with open("converted.docx", "wb") as out: out.write(response.content)
import { readFile, writeFile } from "node:fs/promises"; const key = process.env.FCF_API_KEY; const bytes = await readFile("scan.png"); const form = new FormData(); form.append("file", new Blob([bytes], { type: "image/png" }), "scan.png"); form.append("fast", "false"); const response = await fetch( "https://fileconvertfree.com/api1/v1/image/to-text", { method: "POST", headers: { "X-API-Key": key }, body: form } ); if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`); console.log(await response.json());
JavaScriptの例はサーバー/Node.js環境で使用してください。フロントエンドやブラウザで実行されるJavaScriptに秘密のAPIキーを公開しないでください。
curl -X POST "https://fileconvertfree.com/api1/v1/pdf/to-excel" \ -H "X-API-Key: $FCF_API_KEY" \ -F "file=@sample.pdf" \ --output converted.xlsx
<?php $apiKey = getenv('FCF_API_KEY'); $ch = curl_init('https://fileconvertfree.com/api1/v1/image/to-word'); $file = new CURLFile(__DIR__ . '/scan.png', 'image/png', 'scan.png'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey], CURLOPT_POSTFIELDS => ['file' => $file, 'fast' => 'false'], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 700, ]); $body = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); if ($body === false || $status >= 400) { throw new RuntimeException('API request failed: HTTP ' . $status); } file_put_contents(__DIR__ . '/converted.docx', $body); curl_close($ch);

対応ファイルと検証

PDFエンドポイントは実際のPDFファイルを受け付けます。画像エンドポイントはJPEG/JPG/JFIF、PNG、WebP、GIF、BMP、TIFF/TIFに対応します。APIはファイル名の拡張子と実際のファイルシグネチャの両方を検証するため、未対応ファイルの名前を変更しただけでは検証を回避できません。

レスポンスの動作

ファイル変換エンドポイントは変換済みファイル本体をクライアントへ直接返します。画像からテキストはJSONを返します。内部コンバーターのダウンロードURLはAPI利用者へ公開されません。

HTTPエラーと意味

ステータス意味主な原因 / 対応
401APIキーがない、無効、期限切れ、または無効化されています。X-API-Keyを確認してください。キーを無効化または再生成した場合は現在のシークレットへ更新してください。
403APIアクセスが有効ではありません。アカウントに現在有効なPremiumまたはProの権利がありません。
409キー操作が現在の状態と一致しません。例: 有効なキーを3個より多く作成しようとした、無効なキーを再生成しようとした場合などです。
413アップロードファイルが大きすぎます。APIプランの上限内のファイルを使用してください（現在200MB）。
415未対応または内容と一致しないメディアタイプです。対応するPDF/画像を使用し、正しい拡張子を保持してください。APIはファイルシグネチャも検証します。
422リクエスト内容が無効です。アップロードが空、または必要なmultipartデータが不足・不正な可能性があります。
429リクエストが多すぎます。1分あたりのレート制限またはアカウント全体の1日クォータに達しました。後で再試行するか、日次リセットを待ってください。
5xxAPIまたは変換サービスの一時的な障害です。時間を空けて再試行してください。インフラ/バックエンド障害は1日クォータに課金されません。

クォータの計算方法

1日クォータと1分あたりのレート制限は、同じAPIアカウントのすべてのキーで共有されます。変換前に無効または未対応として拒否されたアップロードは1日クォータを消費しません。サーバーまたはインフラ障害はクォータへ戻されます。変換処理として受理されたリクエストは、下流コンバーターがクライアント側4xxエラーを返した場合でもカウントされることがあります。1日クォータはAPIサーバー/データベースの日付に基づいてリセットされます。

Usage check: GET https://fileconvertfree.com/api1/v1/account/usage

よくある質問

FreeアカウントでAPIを利用できますか？

いいえ。ドキュメントは誰でも閲覧できますが、現在APIアクセスには有効なPremiumまたはProプランが必要です。

キーを3個作るとクォータも3倍になりますか？

いいえ。すべてのキーはアカウント単位の同じ1日クォータと1分あたりの制限を共有します。

失くしたシークレットを確認できますか？

できません。平文のキーは保存されていないため、キーを再生成して新しいシークレットを保存してください。

有料プランが期限切れになるとどうなりますか？

サイトのアカウントに対象となる有効なプランがなくなるとAPIアクセスは無効になります。PremiumまたはProを更新すると対象APIアクセスを再開できます。

FileConvertFreeを連携しますか？

ダッシュボードからキーを作成し、usageエンドポイントで確認してから、アプリに必要な変換ルートを接続してください。

ダッシュボードを開く対話型APIドキュメント