ConvertCraft API ドキュメント

ConvertCraftのファイル変換機能を、REST APIを通じてあなたのアプリケーションに組み込んでください。簡単な HTTP リクエストで画像、PDF、音声、動画、テキストを処理します。

Base URL: https://api.convert-craft.com
OpenAPI spec: /openapi.yaml
RapidAPI: Subscribe on RapidAPI — the fastest way to get started.
Need help? Join our Discord

認証

ほとんどのエンドポイントは公開されており、認証は不要です。より高いレート制限や高度な機能が必要な場合は、RapidAPI を使用して API キーを受け取ってください。

導入 (RapidAPI)

Subscribe on RapidAPI and use RapidAPI's built-in code snippets. The examples below are copy/paste templates — replace YOUR_API_KEY and YOUR_PROXY_SECRET with the values shown in RapidAPI.

1) Health check (GET /status)

curl -s \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-rapidapi-proxy-secret: YOUR_PROXY_SECRET" \
  https://api.convert-craft.com/status

2) Simple JSON tool (POST /slugify)

curl -s -X POST \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-rapidapi-proxy-secret: YOUR_PROXY_SECRET" \
  -d '{"text":"Hello World!"}' \
  https://api.convert-craft.com/slugify

3) File tool example (POST /image-convert)

File endpoints download from the sourceUrl field. Use a direct URL that returns HTTP 200 (this API intentionally does not follow redirects).

curl -s -X POST \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-rapidapi-proxy-secret: YOUR_PROXY_SECRET" \
  -d '{"sourceUrl":"https://example.com/photo.png","outputFormat":"webp"}' \
  https://api.convert-craft.com/image-convert \
  --output photo.webp

サービスカテゴリ

The API provides endpoints grouped by conversion type:

  • 画像処理 — Convert, resize, and optimize images (JPG, PNG, WebP, AVIF, HEIC, SVG, GIF, TIFF, BMP, ICO)
  • PDFツール — Convert, merge, split, compress, and rasterize PDFs
  • 音声処理 — Convert between MP3, WAV, OGG, AAC, FLAC, M4A formats
  • 動画処理 — Convert MP4, WebM, MKV, MOV, AVI, extract audio from video
  • テキストツール — Slugify, hash, encode/decode, and other text operations
  • 暗号通貨ツール — Hashing, encoding, and cryptographic utilities
  • システム — Health check, status, and API metadata

For the full list of endpoints with request/response schemas, see the OpenAPI spec.

制限

  • Free tier: 10 requests per minute
  • Pro tier: 100 requests per minute
  • Enterprise: Custom limits available on request

公開エンドポイントはIPアドレスあたりに制限されます。RapidAPIのサブスクライバーは、より高い制限を受けます。

Error Handling

All errors return JSON with a consistent structure:

{
  "error": "short_code",
  "message": "Human-readable description"
}

Common HTTP status codes:

  • 400 — Bad request (missing or invalid parameters)
  • 401 — Unauthorized (missing or invalid API key)
  • 403 — Forbidden (invalid proxy secret or insufficient permissions)
  • 429 — Rate limit exceeded
  • 500 — Internal server error

Support

For API questions, bug reports, or feature requests, email [email protected] or join our Discord community.