图图拍拍
图图拍拍
69 个 MCP 工具 + 完整 REST API

图图拍拍 API 文档

通过 REST API 或 MCP 协议，让 AI 助手直接完成照片打印、文档打印、订单管理等全部操作。 支持 Claude、Gemini、Codex、Copilot 等 21 个主流 AI 客户端。

快速开始

三步接入，即刻使用 AI 完成打印任务。

1

注册账号

访问图图拍拍网站，手机号验证码快速注册。

2

创建 API Key

在个人中心「API 密钥」页面，一键创建密钥，即刻可用。

3

发起请求

使用 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
GET /api/documents
GET /api/documents/{id}
DELETE /api/documents/{id}

照片管理

POST /api/photos/upload
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
POST /api/payment/balance
GET /api/payment/status/{order_id}

余额

GET /api/user/balance
POST /api/user/balance/topup
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
GET /api/print-options/sizes
GET /api/print-options/paper-types

AI 照片修复

POST /api/photos/{id}/restore
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
POST /api/user/api-keys
DELETE /api/user/api-keys/{id}

系统健康

GET /api/health

MCP 工具列表 69 个

通过 MCP 协议可调用以下全部工具，AI 客户端配置后自动发现。

文档管理

upload_document 上传文档 (PDF/DOC/DOCX/XLS/XLSX/PPT/PPTX) — 三选一: file_url / content (base64) / file_path (curl)
list_documents 列出当前用户的所有已上传文档
get_document_info 获取文档详细信息 (页数、文件大小等)
delete_document 删除文档 (仅限未关联有效订单)

照片管理

upload_photo 上传照片 (JPG/PNG/WebP/HEIC) — 三选一: file_url / content (base64) / file_path (curl)
get_photo 获取照片详细信息
delete_photo 删除照片 (仅限未关联有效订单)
check_photo_quality 检查照片在指定尺寸下的打印质量 (DPI)

订单

create_order 创建打印订单
list_orders 列出当前用户的所有订单
get_order_status 查询订单状态和详情
cancel_order 取消订单 (仅待支付状态)
track_order 通过订单号查询订单信息 (公开)
get_order_tracking 获取订单物流追踪信息

支付与余额

create_payment 创建第三方支付 (返回 payment_url，可在浏览器打开完成支付)
pay_with_balance 使用账户余额支付订单
get_payment_status 查询订单支付状态
create_topup 创建余额充值订单 (返回 payment_url)
get_balance 查询账户余额 (总余额/冻结/可用)
get_balance_transactions 查询余额交易记录

优惠券

list_coupons 列出当前用户的优惠券
get_available_coupons 获取可用优惠券 (可按金额筛选)
redeem_coupon 通过兑换码领取优惠券

收货地址

list_addresses 列出收货地址列表
create_address 新增收货地址
update_address 更新收货地址
delete_address 删除收货地址
parse_address 智能解析地址文本

帮人下单 (预下单)

list_pre_orders 列出所有预下单
create_pre_order 创建预下单 (分享链接让他人提交)
get_pre_order 获取预下单详情 (含所有提交)
update_pre_order 更新预下单设置
update_pre_order_status 更改预下单状态
review_submission 审核预下单的提交
cancel_submission 取消某次提交

预下单分享

get_share_info 获取分享链接信息
submit_share_photos 向分享链接提交照片
get_submission_status 查询提交的状态和照片详情
list_my_submissions 列出在某分享链接下的所有提交

售后

list_after_sales 列出当前用户的售后记录
create_after_sales 创建售后申请 (退款/重打/重寄)

区域与配送

list_regions 查询地区列表
get_region 获取地区详情及子地区
get_region_tree 获取完整地区树 (省→市→区县)
get_region_coverage 获取代理覆盖统计
get_city_coverage 获取城市下各区县覆盖情况
get_agent_by_referral 通过推广码查找代理
check_express_delivery 检查是否支持今日达服务
get_shipping_config 获取配送运费配置 (全局)
get_shipping_carriers 获取快递公司列表 (含偏远附加费)
list_pickup_points 查询自提点列表

配置与状态

get_print_prices 获取打印价格 + 梯度折扣阶梯
get_print_options 获取可用尺寸和纸张类型
get_printer_status 查询打印机状态
get_queue_status 查询打印队列状态

用户信息

get_profile 获取当前用户个人信息
update_profile 更新用户昵称

AI 照片修复

restoration_preview 对照片进行 AI 修复预览
get_restoration 获取 AI 修复任务结果

API 密钥自管理

list_api_keys 列出当前用户的所有 API Key
create_api_key 创建新的 API Key (仅显示一次完整密钥)
revoke_api_key 撤销指定的 API Key

系统

health_check 检查服务健康状态 (数据库/支付网关/版本)
get_auto_print_schedule 获取自动打印的时间窗口设置

订单评价

submit_order_review 提交单条订单评价（3 维度评分 + 评论）；ON CONFLICT 幂等；限流 5/h
batch_submit_order_reviews 批量评价（max 20 · 单事务 · 原子成功）；一键 5 星好评
list_my_order_reviews 列出我的评价（分页信封）
get_order_review 获取单条评价详情（含官方回复）
mark_order_review_read 标记官方回复已读（CTE 防重放，减少 nav badge 计数）

代码示例

完整的「查询价格 → 上传文件 → 创建订单 → 余额支付」流程示例。

# 查询打印价格
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 密钥