開発者向け APIリファレンス

ImageToURLの開発者向けメモ。公開APIキーによるアップロードはまだ有効ではありません。本番用リンクには現在Webアップローダーを使用してください。

スタートガイド

ImageToURL APIはRESTに基づいて設計されています。予測可能なリソース指向のURL、JSONエンコードされたレスポンス、標準的なHTTPレスポンスコード、認証、動詞を使用します。

ベースURL 本番環境

https://imagetourl.cloud/api

認証

ImageToURL APIはAPIキーを使用してリクエストを認証します。ダッシュボードでAPIキーを表示・管理できます。APIキーには多くの権限がありますので、安全に保管してください！

Public API-key uploads are not live yet.

The current upload route is used by the ImageToURL website uploader
and requires a same-site browser request from imagetourl.cloud.

画像をアップロード

POST /api/upload

WebサイトからアップロードしてCDNキャッシュ済みURLを受け取ります。ゲストアップロードは期限切れになり、ログインユーザーはアップロード前に永久リンクを選択できます。

パラメーター

名前	タイプ	説明
file	binary	画像ファイル（PNG、JPG、WebP）最大50MB。
expires_in	string	オプションの有効期間（秒）。
adblock	string	保存先フォルダ名。

レスポンス例 200 OK

{
  "success": true,
  "data": {
    "id": "img_ab12cd34",
    "url": "https://imagetourl.cloud/ab12cd34.png",
    "filename": "my_image.png",
    "size": 102488,
    "mimetype": "image/png",
    "created_at": "2026-07-06T10:00:00.000Z"
  }
}