69 個 MCP 工具 + 完整 REST API

圖圖拍拍 API 文件

通過 REST API 或 MCP 協議，讓 AI 助手直接完成照片列印、文件列印、訂單管理等全部操作。
支援 Claude、Gemini、Codex、Copilot 等 21 個主流 AI 客戶端。

快速開始

三步接入，即刻使用 AI 完成列印任務。

註冊賬號

訪問圖圖拍拍網站，手機號驗證碼快速註冊。

建立 API Key

在個人中心「API 金鑰」頁面，一鍵建立金鑰，即刻可用。

發起請求

使用 API Key 呼叫 REST API，或配置到 AI 客戶端使用 MCP。

認證方式

所有 API 請求通過 HTTP Header 攜帶 API Key 認證。

Authorization: Bearer tk_YOUR_API_KEY

Base URL

https://tutupp.com

響應格式

Content-Type: application/json

MCP 端點

POST https://tutupp.com/api/mcp

開放平臺：註冊賬號後即可建立 API Key，無需審批，立即使用全部 API 和 MCP 功能。

MCP 整合

MCP (Model Context Protocol) 是 Anthropic 提出的開放協議，讓 AI 助手直接呼叫外部工具。

配置後，你可以用自然語言指揮 AI 完成「上傳文件 → 建立訂單 → 餘額支付」的完整流程。

協議資訊

端點：https://tutupp.com/api/mcp

協議：JSON-RPC 2.0 over Streamable HTTP

方法：initialize · tools/list · tools/call

檔案上傳：支援 multipart/form-data 擴充套件 (message part + file parts，零 base64，100MB+) 和標準 application/json

選擇你的 AI 客戶端 21 個

Claude Code — 終端 CLI

新增 (Add)

claude mcp add --transport http tutupp https://tutupp.com/api/mcp --header "Authorization: Bearer tk_YOUR_API_KEY"

新增 --scope user 全域性生效，--scope project 僅當前專案

替換金鑰 (Replace)

claude mcp remove tutupp && claude mcp add --transport http tutupp ...(新金鑰)

移除 (Remove)

claude mcp remove tutupp

AI 對話示例

你：幫我把桌面上的 report.pdf 列印一份，A4 黑白，用餘額付款

AI 自動呼叫：

1. upload_document → 上傳檔案

2. get_print_prices → 查詢 A4 黑白價格

3. create_order → 建立訂單

4. pay_with_balance → 餘額支付

AI：已完成！訂單號 PP2026040612345，A4 黑白 1 份，已從餘額扣除 ¥0.50。

REST API 參考

API Key 可訪問以下所有端點，覆蓋介面全部功能。

文件管理

POST /api/documents/upload 上傳文件 (multipart/form-data, PDF/DOC/DOCX/XLS/XLSX/PPT/PPTX, ≤50MB)

GET /api/documents 列出我的文件

GET /api/documents/{id} 獲取文件詳情

DELETE /api/documents/{id} 刪除文件

照片管理

POST /api/photos/upload 上傳照片 (multipart/form-data, JPEG/PNG/WebP/HEIC, ≤120MB)

GET /api/photos/{id} 獲取照片詳情

DELETE /api/photos/{id} 刪除照片

GET /api/photos/{id}/quality-check?size={size} 檢查照片列印質量

訂單

POST /api/orders 建立列印訂單

GET /api/orders 列出我的訂單

GET /api/orders/{id} 獲取訂單詳情

PUT /api/orders/{id}/cancel 取消訂單

GET /api/orders/track/{order_no} 按訂單號追蹤

GET /api/orders/{id}/tracking 獲取物流追蹤資訊

支付

POST /api/payment/create 建立第三方支付 (支付寶/微信，返回 payment_url)

POST /api/payment/balance 餘額支付訂單

GET /api/payment/status/{order_id} 查詢支付狀態

餘額

GET /api/user/balance 查詢餘額

POST /api/user/balance/topup 發起充值 (返回 payment_url)

GET /api/user/balance/transactions 餘額流水

優惠券

GET /api/user/coupons 我的優惠券列表

GET /api/user/coupons/available 可用優惠券 (可按金額/範圍篩選)

POST /api/user/coupons/redeem 兌換優惠碼

收貨地址

GET /api/addresses 地址列表

POST /api/addresses 新建地址

PUT /api/addresses/{id} 修改地址

DELETE /api/addresses/{id} 刪除地址

POST /api/addresses/parse 智慧解析地址文本

幫人下單 (預下單)

GET /api/user/pre-orders 預下單列表

POST /api/user/pre-orders 建立預下單

GET /api/user/pre-orders/{id} 預下單詳情

PUT /api/user/pre-orders/{id} 更新預下單

PUT /api/user/pre-orders/{id}/status 更改預下單狀態

POST /api/user/pre-orders/{id}/submissions/{sid}/review 稽核提交

PUT /api/user/pre-orders/{id}/submissions/{sid}/cancel 取消提交

預下單分享

GET /api/share/{code} 獲取分享連結資訊

POST /api/share/{code}/submit 提交照片到分享連結

GET /api/share/{code}/submissions/{sid} 查詢提交狀態

GET /api/share/{code}/my-submissions 我的提交列表

售後

GET /api/user/after-sales 我的售後列表

POST /api/after-sales 發起售後請求 (退款/重打/重寄)

區域與配送

GET /api/regions 地區列表 (可按層級/上級/關鍵詞篩選)

GET /api/regions/{id} 地區詳情及子地區

GET /api/regions/tree 完整地區樹 (省→市→區縣)

GET /api/regions/coverage 代理覆蓋統計

GET /api/regions/{city_id}/city-coverage 城市區縣覆蓋情況

GET /api/regions/{id}/express-delivery 檢查今日達服務

GET /api/regions/{id}/pickup-points 自提點列表

GET /api/agents/referral/{code} 通過推廣碼查詢代理

GET /api/shipping/config 運費配置 (全域性)

GET /api/shipping/carriers 快遞公司列表 (含偏遠附加費)

配置查詢

GET /api/prices 列印價格 + 梯度折扣 ({prices, volume_tiers})

GET /api/print-options/sizes 可用尺寸

GET /api/print-options/paper-types 可用紙張

AI 照片修復

POST /api/photos/{id}/restore 發起 AI 修復預覽

GET /api/restorations/{id} 獲取修復結果

使用者資訊

GET /api/auth/me 獲取當前使用者資訊

PUT /api/auth/me 更新個人資料

列印狀態

GET /api/printer/status 印表機狀態

GET /api/print-queue/status 列印佇列狀態

GET /api/orders/auto-print-schedule 獲取自動列印時間視窗

API 金鑰自管理

GET /api/user/api-keys 列出我的 API Key

POST /api/user/api-keys 建立 API Key (僅返回一次完整金鑰)

DELETE /api/user/api-keys/{id} 撤銷 API Key

系統健康

GET /api/health 服務健康檢查 (無需認證，監控/K8s probe)

MCP 工具列表69 個

通過 MCP 協議可呼叫以下全部工具，AI 客戶端配置後自動發現。

文件管理

upload_document 上傳文件 (PDF/DOC/DOCX/XLS/XLSX/PPT/PPTX) — 三選一: file_url / content (base64) / file_path (curl) file_url | content | file_path, filename?

list_documents 列出當前使用者的所有已上傳文件

get_document_info 獲取文件詳細資訊 (頁數、檔案大小等) document_id

delete_document 刪除文件 (僅限未關聯有效訂單) document_id

照片管理

upload_photo 上傳照片 (JPG/PNG/WebP/HEIC) — 三選一: file_url / content (base64) / file_path (curl) file_url | content | file_path, filename?

get_photo 獲取照片詳細資訊 photo_id

delete_photo 刪除照片 (僅限未關聯有效訂單) photo_id

check_photo_quality 檢查照片在指定尺寸下的列印質量 (DPI) photo_id, size

訂單

create_order 建立列印訂單 items[], delivery_method?, shipping_carrier_id?, coupon_id?

list_orders 列出當前使用者的所有訂單

get_order_status 查詢訂單狀態和詳情 order_id

cancel_order 取消訂單 (僅待支付狀態) order_id

track_order 通過訂單號查詢訂單資訊 (公開) order_no

get_order_tracking 獲取訂單物流追蹤資訊 order_id

支付與餘額

create_payment 建立第三方支付 (返回 payment_url，可在瀏覽器開啟完成支付) order_id, payment_method?

pay_with_balance 使用賬戶餘額支付訂單 order_id

get_payment_status 查詢訂單支付狀態 order_id

create_topup 建立餘額充值訂單 (返回 payment_url) amount, payment_method?

get_balance 查詢賬戶餘額 (總餘額/凍結/可用)

get_balance_transactions 查詢餘額交易記錄 page?, page_size?

優惠券

list_coupons 列出當前使用者的優惠券 scope?

get_available_coupons 獲取可用優惠券 (可按金額篩選) amount?, scope?

redeem_coupon 通過兌換碼領取優惠券 code

收貨地址

list_addresses 列出收貨地址列表

create_address 新增收貨地址 name, phone, province, city, district, detail, ...

update_address 更新收貨地址 address_id, ...

delete_address 刪除收貨地址 address_id

parse_address 智慧解析地址文本 text

幫人下單 (預下單)

list_pre_orders 列出所有預下單

create_pre_order 建立預下單 (分享連結讓他人提交) title, order_type, spec_mode, ...

get_pre_order 獲取預下單詳情 (含所有提交) pre_order_id

update_pre_order 更新預下單設定 pre_order_id, ...

update_pre_order_status 更改預下單狀態 pre_order_id, status

review_submission 稽核預下單的提交 pre_order_id, submission_id, approved, reject_reason?

cancel_submission 取消某次提交 pre_order_id, submission_id

預下單分享

get_share_info 獲取分享連結資訊 share_code

submit_share_photos 向分享連結提交照片 share_code, photo_ids[], password?, ...

get_submission_status 查詢提交的狀態和照片詳情 share_code, submission_id

list_my_submissions 列出在某分享連結下的所有提交 share_code

售後

list_after_sales 列出當前使用者的售後記錄

create_after_sales 建立售後申請 (退款/重打/重寄) order_id, type, reason, ...

區域與配送

list_regions 查詢地區列表 level?, parent_id?, search?

get_region 獲取地區詳情及子地區 region_id

get_region_tree 獲取完整地區樹 (省→市→區縣)

get_region_coverage 獲取代理覆蓋統計

get_city_coverage 獲取城市下各區縣覆蓋情況 city_id

get_agent_by_referral 通過推廣碼查詢代理 referral_code

check_express_delivery 檢查是否支援今日達服務 region_id

get_shipping_config 獲取配送運費配置 (全域性)

get_shipping_carriers 獲取快遞公司列表 (含偏遠附加費)

list_pickup_points 查詢自提點列表 region_id

配置與狀態

get_print_prices 獲取列印價格 + 梯度折扣階梯

get_print_options 獲取可用尺寸和紙張型別

get_printer_status 查詢印表機狀態

get_queue_status 查詢列印佇列狀態

使用者資訊

get_profile 獲取當前使用者個人資訊

update_profile 更新使用者暱稱 nickname

AI 照片修復

restoration_preview 對照片進行 AI 修復預覽 photo_id

get_restoration 獲取 AI 修復任務結果 restoration_id

API 金鑰自管理

list_api_keys 列出當前使用者的所有 API Key

create_api_key 建立新的 API Key (僅顯示一次完整金鑰) name, expires_in_days?

revoke_api_key 撤銷指定的 API Key api_key_id

系統

health_check 檢查服務健康狀態 (資料庫/支付閘道器/版本)

get_auto_print_schedule 獲取自動列印的時間視窗設定

訂單評價

submit_order_review 提交單條訂單評價（3 維度評分 + 評論）；ON CONFLICT 冪等；限流 5/h order_id, rating_print, rating_shipping?, rating_service?, comment?

batch_submit_order_reviews 批次評價（max 20 · 單事務 · 原子成功）；一鍵 5 星好評 items[{order_id, rating_print, ...}]

list_my_order_reviews 列出我的評價（分頁信封） page?, limit?

get_order_review 獲取單條評價詳情（含官方回覆） review_id

mark_order_review_read 標記官方回覆已讀（CTE 防重放，減少 nav badge 計數） review_id

程式碼示例

完整的「查詢價格 → 上傳檔案 → 建立訂單 → 餘額支付」流程示例。

# 查询打印价格
curl https://tutupp.com/api/prices \
  -H "Authorization: Bearer tk_YOUR_API_KEY"

# 上传文档
curl -X POST https://tutupp.com/api/documents/upload \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -F "file=@report.pdf"

# 创建订单
curl -X POST https://tutupp.com/api/orders \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [{
      "document_id": "uuid-here",
      "size": "A4",
      "paper_type": "matte",
      "quantity": 1
    }],
    "delivery_method": "pickup"
  }'

# 余额支付
curl -X POST https://tutupp.com/api/payment/balance \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_id": "uuid-here"}'

典型工作流

上傳檔案查詢價格建立訂單餘額支付完成

錯誤處理

API 使用標準 HTTP 狀態碼，錯誤響應包含 JSON 格式的錯誤資訊。

// 錯誤響應格式
{
  "error": "錯誤描述資訊"
}

400

請求引數錯誤缺少必填欄位、格式不正確

401

未認證 API Key 缺失或無效

403

無許可權操作被禁止、許可權不足

404

資源不存在訂單/文件/照片 ID 不存在

409

衝突照片已關聯訂單不可刪除

413

檔案過大文件超過 50MB / 照片超過 120MB

422

業務規則不滿足餘額不足、訂單狀態不可取消

429

請求頻率過高超過 API 限流閾值

500

伺服器內部錯誤請稍後重試，或聯絡支援

限流：僅對登入 / 註冊 / 驗證碼等敏感寫操作做攻擊防護，普通使用者正常使用絕不會觸發；閾值在管理後臺可配。響應攜帶 retry_after_seconds 欄位 + Retry-After 響應頭。

準備好開始了嗎？

註冊賬號，建立 API Key，讓 AI 幫你完成列印任務。

立即註冊管理 API 金鑰