Pasty 使い方

1これは何か

向いている用途：自分の端末間でテキストやファイルを移す、目の前の相手にコードを口頭で伝える、Pod やサーバー上の成果物を遠隔の相手に渡す、顧客に短期間だけ有効なダウンロードリンクを渡す。

向かない用途：取り消しが必要なもの、長期保存が必要なもの、鍵・認証情報・個人情報（§7 参照）。

2ウェブでの使い方

2.1 作成する

pasty.youlidao.ai を開くと、既定で「作成」タブです。

1. テキスト：入力欄に入力または貼り付け。右下に 使用中 / 50,000 が出て、超えると赤くなりボタンが無効になります。
2. ファイル（任意）：破線の領域にドロップ、クリックして選択、またはテキスト欄にフォーカスがない状態で ⌘V（Windows は Ctrl+V）でクリップボードの画像を貼り付け。ファイルは1つだけで、複数落とすと最初の1つだけを取り、その旨を表示します。画像はサムネイル、それ以外はアイコン・名前・サイズ・MIME を表示し、× で外せます。
3. 有効期限：ドロップダウン、既定は「1日」。
4. 「作成する」を押します。ファイルがある場合はボタンが進捗表示になります。テキストが 50,000 文字超、ファイルが 100MB 超の場合はブラウザ側で送信前に弾きます。
5. 結果画面：大きな共有コード、期限、コードのコピー、続けて作成。

2.2 受け取る

• コードで：トップページの「受け取る」タブで 6 文字を入力します。入力欄は自動で大文字化し、集合にない文字は落としますが——黙って消すのではなく、何を無視したかを表示します。6 文字揃って 0.5 秒後に自動で照会して遷移し、ボタンを押せば即座に照会します。存在しないコードは入力欄を空にして知らせます。
• リンクで：https://pasty.youlidao.ai/{CODE}、大文字小文字は問いません。

2.3 閲覧ページの見え方

右上に残り時間（「残り 4 分」「残り 3 時間」「残り 6 日」）が出ます。その下は内容の種類ごとに：

10 秒応答がない場合はタイムアウトを通知します。

2.4 相手への渡し方3種

3コマンドライン / スクリプトからの利用

3.1 テキストを送る

curl -s -X POST https://pasty.youlidao.ai/api/pastes \
  -H 'Content-Type: application/json' \
  -d '{"content":"共有したいテキスト","expiresIn":"1h"}'
# → {"code":"7FZEN4","expiresAt":"2026-09-09T16:56:23.246Z"}

内容がファイル由来のときは、手で エスケープせず jq で JSON を組み立てます：

jq -n --rawfile c notes.md '{content:$c, expiresIn:"1d"}' \
  | curl -s -X POST https://pasty.youlidao.ai/api/pastes \
      -H 'Content-Type: application/json' --data @-

3.2 ファイルを送る（説明も添えられます）

curl -s -m 120 -X POST https://pasty.youlidao.ai/api/pastes \
  -F "file=@/path/レポート.pdf" \
  -F "content=これが何かを一言で" \
  -F "expiresIn=1h"
# → {"code":"KTCK33","expiresAt":"…","hasFile":true}

• 複数ファイルはまず zip -r で1つにまとめてください。ファイル用エンドポイントは IP あたり毎分 5 回までなので、ループで1つずつ上げないこと。
• type= の指定は不要です。サーバーがファイルの中身から MIME を判定します（§4.4）。
• ファイル名は日本語を含む Unicode をそのまま保持します。

3.3 取り出す

# メタデータ＋テキスト
curl -s https://pasty.youlidao.ai/api/pastes/KTCK33
# テキストだけ
curl -s https://pasty.youlidao.ai/api/pastes/KTCK33 | jq -r .content
# ファイルをダウンロード（-J でサーバー側の名前、-O で保存）
curl -s -O -J https://pasty.youlidao.ai/api/pastes/KTCK33/file

3.4 マシン間でファイルを移すときの推奨手順

# 送信側
shasum -a 256 FILE
curl -s -X POST https://pasty.youlidao.ai/api/pastes -F "file=@FILE" -F "expiresIn=30m"
# 受信側
curl -s -O -J https://pasty.youlidao.ai/api/pastes/CODE/file
shasum -a 256 FILE   # 送信側と比較

転送自体は無劣化です（zip / png の往復でバイト一致を実測）。チェックサムはコードの取り違えや途中で切れたダウンロードを検出するためのものです。

JSON テキストしか送れない環境（古いスクリプト、制限付きサンドボックス）では base64 に退避できます：base64 -i FILE | tr -d '\n' を content として送り、受信側で base64 -d。base64 は容積が ×1.33 になり 100KB の本体制限も受けるので、小さなファイル向けです。

4API リファレンス

4.1 エンドポイント一覧

作成時の応答には必ずレート制限ヘッダが付きます：ratelimit-limit、ratelimit-remaining、ratelimit-reset（秒）、ratelimit-policy（例 10;w=60）。超過時は 429 を返し、code は RATE_LIMITED（テキスト）または FILE_RATE_LIMITED（ファイル）です。

4.2 POST /api/pastes · JSON

{ "content": "必須。前後の空白を除いて非空、50,000 文字以内",
  "expiresIn": "5m | 30m | 1h | 1d | 7d（省略可、既定は 1d）" }
// 201
{ "code": "7FZEN4", "expiresAt": "2026-09-09T16:56:23.246Z" }

検証失敗時の形（details は JSON 経路にのみ付きます）：

{ "error": "Content must not be empty",
  "code": "CONTENT_EMPTY",
  "details": [ { "path": "content", "message": "CONTENT_EMPTY" } ] }

4.3 POST /api/pastes · multipart

201 の応答は { "code", "expiresAt", "hasFile": true }。ファイルがなければ hasFile は付きません。処理順は R2 が先で、成功して初めて Redis に書きます。R2 が失敗すれば何も残らず、Redis が失敗すれば R2 のオブジェクトを消して巻き戻します。

ファイル名の規則：

• 255 文字超 → 400 FILENAME_TOO_LONG
• ../、..\ やその URL エンコード形を含む → 400 FILENAME_INVALID、セキュリティログに記録
• / \ : * ? " < > | は _ に置換、先頭のドットと空白は除去
• 名前が空 → MIME から unnamed.png のように補完
• 日本語などの Unicode はそのまま保持（以前は latin1 で文字化けしていました）

4.4 MIME の判定 — プレビューかダウンロードかを決める

サーバーはクライアントが申告した Content-Type をそのままは信用せず、次の順で決めます：

1. ファイルのマジックナンバー（画像、PDF、zip、Office、音声・動画などのバイナリ形式）
2. クライアントの申告。ただし非空かつ application/octet-stream でない場合のみ（マジックナンバーを持たない txt / csv / json / svg を拾います）
3. 拡張子
4. application/octet-stream

その結果、curl -F file=@x.zip は application/zip として保存され、拡張子も申告もない PDF も PDF と認識されてインライン表示でき、PDF を .txt に改名して上げても PDF として扱われます。

4.5 GET /api/pastes/:code

コードはちょうど 6 文字かつすべて集合内でなければ 400 になります。サーバー側で大文字に揃えます。

{
  "content": "説明文（ファイルのみのときは空文字列）",
  "type": "text | file | mixed",
  "fileMetadata": {
    "fileName": "スクリーンショット.png", "fileSize": 74, "mimeType": "image/png",
    "storageKey": "pastes/U9RBRW/スクリーンショット.png"
  },
  "createdAt": "2026-09-09T17:00:41.045Z",
  "expiresAt": "2026-09-09T17:05:41.045Z"
}

type と fileMetadata はファイルがあるときだけ出ます。初期のテキストのみの記録には type 自体がないことがあり、その場合は text として扱ってください。

4.6 GET /api/pastes/:code/file

ファイル本体をストリームで返します。メモリには溜めません。応答ヘッダ：

4.7 エラーコード一覧

エラー応答はすべて { "error": <英語の説明>, "code": <識別子> } です。プログラムでの判定には code を使ってください。こちらが安定した契約で、error は人が読むための英語の文章であり表現は変わりえます。ウェブ側は error を表示せず、code から自前の辞書を引いて閲覧者の言語で表示します。

5Claude Code / cc-hub との連携

youlidao.ai の cc-hub セッションと建造センターの Pod には pasty-share skill（v3）が入っています。「これを送って」「このファイルを顧客へ」と AI に頼むと：

1. multipart で元のファイルそのものを上げます。skill の鉄則として、PDF や Word を markdown に変換して送ることは禁止されています
2. 既定は expiresIn=1h。複数ファイルはまず zip にまとめます
3. 共有コードと閲覧リンクを返し、画像と PDF には /file の直リンクも添えます
4. 毎回、有効期限と「コードを持つ人は誰でも読める」ことを明示します

skill の禁止事項：.env、秘密鍵、トークン、認証情報、データベースのダンプは送らない。内容が機微かもしれない場合はユーザーに確認する。それでも送るなら 5m / 30m を使う。

6データのライフサイクル

共有コードは CSPRNG に棄却サンプリングを掛けて一様に生成します。31 の 6 乗 = 887,503,681 通りで、衝突時は最大 5 回まで引き直します。

7安全上の境界（使う前に必読）

• 認証はありません：コードが唯一の鍵で、コードやリンクを手にした人は誰でも読めます。リンクをグループに貼れば全員が読めます。
• 取り消せません：誤って送ったら期限を待つしかありません。迷うときは 5 分か 30 分にしてください。
• 送ってはいけないもの：パスワード、API キー、秘密鍵、証明書、.env、個人情報を含むデータ。
• アップロードした内容は実行されません：画像と PDF のインライン応答には sandbox CSP が付くので、スクリプト入りの SVG を上げても動きません（実ブラウザで確認済み）。HTML や zip は常に添付としてダウンロードされ、描画されません。
• 他サイトから iframe で埋め込めません（frame-ancestors 'self'）。
• 内容ページは検索エンジンに載りません：robots.txt が共有コードのパスのクロールを禁じ、応答にも X-Robots-Tag: noindex が付きます。これはクローラー対策であって、コードを持つ人には効きません。
• ホストされた HTML ページ（§9）は /p/{CODE} でのみ表示され、専用のサンドボックス CSP が付きます：別オリジン扱い、API 呼び出し不可、フォーム送信不可。作成にはトークンが必要です。

8よくある質問

ブラウザで ERR_CONNECTION_CLOSED、または curl が 000 を返す

中国本土からの直接接続で時々起きます。再読み込みか一度の再試行で通ります。ヘルスチェックと読み取りのエンドポイント自体は安定しています。

作成ボタンが灰色のまま

テキストが空でファイルも選んでいないか、テキストが 50,000 文字を超えています（カウンタが赤くなります）。

スマホで PDF の1ページ目しか見えない

iOS Safari の埋め込み枠の制限です。「新しいタブで開く」を使ってください。

日本語のファイル名が文字化けしてダウンロードされる

2026-09-10 より前にアップロードされた記録だけです（当時サーバーが latin1 で名前を解釈していました）。以降の分は修正済みで、古い記録は期限で消えます。

curl で上げた zip が以前 application/octet-stream になっていた

curl は .zip を知らないので octet-stream と申告し、旧版はそれをそのまま信じていました。今はファイルの中身から判定するので ;type= は不要です。

内容の編集・削除・期限の延長はできますか

できません。そのためのエンドポイントがないので、作り直してください。

429 が返ったら

応答ヘッダの ratelimit-reset（秒）だけ待ってください。テキストは毎分 10 回、ファイルは毎分 5 回、IP 単位です。複数ファイルは zip にまとめてください。

日本語の長文が 413 request entity too large で送れない

JSON 本体の上限が 100KB です。multipart の content フィールドを使うか、分割してください。

画面の言語は変えられますか

変えられます。フッターに言語選択（简体中文 / English / 日本語 / 한국어）があり、選択は端末に保存されます。?lang=ja のように直接指定することもできます。

9HTML ページのホスティング：AI エージェント向けの一時的な Web ページ

9.1 何のための機能か

AI エージェントがレポート、ダッシュボード、プロトタイプを作ったとき、相手に渡したいのはダウンロードするファイルではなく開けばすぐ見られる URL です。HTML ドキュメントを 1 つ POST すると https://pasty.youlidao.ai/p/{CODE} が返り、期限が来ると自動で消えます。

9.2 ページを作成する

curl -s -X POST https://pasty.youlidao.ai/api/pages \
  -H "Authorization: Bearer $PASTY_PAGE_TOKEN" \
  -F "file=@report.html" \
  -F "expiresIn=7d"
# → {"code":"MN3W2R","expiresAt":"…","url":"https://pasty.youlidao.ai/p/MN3W2R"}

HTML がすでに変数に入っている場合は JSON で送ります。フィールド名は html です：

jq -n --rawfile h report.html '{html:$h, expiresIn:"1d"}' \
  | curl -s -X POST https://pasty.youlidao.ai/api/pages \
      -H "Authorization: Bearer $PASTY_PAGE_TOKEN" \
      -H 'Content-Type: application/json' --data @-

• 201 のレスポンス：{ "code", "expiresAt", "url" }。相手に送るのは url です。
• JSON のリクエストボディはエスケープの分を見込んでページ上限の 2 倍まで受け付けます。5MB に近いページは multipart を使ってください。
• トークンは環境変数に置き、ページ・ログ・チャットには書かないでください。

9.3 開いたときにページができること

/p/{CODE} は text/html; charset=utf-8 として、専用の CSP 付きで返されます：

サンドボックスにより、ページのスクリプトは pasty 本体になりすますことも、このサイトの保存データを読むこともできません。外部送信の禁止は、ページをフィッシングフォームとして使わせないためのものですが、完全ではありません（画像 URL やページ遷移でデータを持ち出せます）。本当の関門は作成時のトークンです。

コードが存在しない、期限切れ、またはページではなくテキストやファイルの場合は /{CODE} へ 302 でリダイレクトし、通常の閲覧ページで状況を表示します。匿名のファイルアップロードで送られた .html は常にダウンロード扱いで、/p/ で表示されることはありません。

9.4 ページを書く AI 向けチェックリスト

1. 1 ファイルで完結：CSS と JS はインライン、画像は data: URI か https のリンク、ライブラリは cdnjs.cloudflare.com, cdn.jsdelivr.net, unpkg.com, cdn.tailwindcss.com からバージョンを固定して読み込む。
2. 通信に頼らない：JSON を fetch せず、データはページに直接書く。
3. localStorage を使わない。どうしても使う場合は try/catch で囲み、なくても表示できるようにする。
4. <meta charset="utf-8"> と viewport を書き、スマートフォンでも読めるようにする。中国本土からは Google Fonts が不安定なので、フォントには必ずシステムフォントの代替を指定する。
5. 有効期限は既定で 1d、人に見せるレポートなら 7d。返信では url と有効期限を伝え、リンクを知っていれば誰でも見られることを明記する。
6. 秘密鍵、個人情報、社内の認証情報は載せない。ルールは §7 と同じ。

機械向けの完全な説明は /llms.txt にあります。

9.5 PDF に書き出す

ホストされたページには右下に「Export PDF」ボタンがあります（ブラウザの言語が中国語の読者には中国語で表示）。リンク先は /p/{CODE}/pdf で、このアドレスをそのまま共有することもできます。

• サーバーが同じ /p/{CODE} を同じサンドボックス規則のもと Chromium で開き、A4 の PDF にします。背景色は残し、常にライトモードで出力し、ボタン自体は PDF に含めません。
• 初回の書き出しには数秒から 15 秒ほどかかります。結果はキャッシュされ、以降はそのまま返します。PDF はページと同時に期限切れになり、一緒に削除されます。
• inline とファイル名付きで返すため、スマートフォンやアプリ内ブラウザではその場でプレビューでき、パソコンでは保存できます。
• レート制限は IP ごとに 1 分あたり 10 回。描画に失敗すると 503 PDF_EXPORT_UNAVAILABLE を返すので、再試行してください。
• きれいに書き出すには、ホバーやクリックで初めて表示される内容を避け、幅の広い表は横スクロールできるコンテナに入れてください。PDF では A4 幅に合わせて折り返されます。