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

图图拍拍 API 文档

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

快速开始

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

1

注册账号

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

2

创建 API Key

在「个人设置 → 开发者」中创建密钥，需管理员审批开启。

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 权限，并确保平台 API 功能全局开启。

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

选择你的 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/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/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

MCP 工具列表 56 个

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

文档管理

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

照片管理

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

订单

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

支付与余额

pay_with_balance 使用账户余额支付订单
get_payment_status 查询订单支付状态
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 获取配送运费配置
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 修复任务结果

代码示例

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

# 查询打印价格
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
无权限 API 访问未开启、操作被禁止
404
资源不存在 订单/文档/照片 ID 不存在
409
冲突 照片已关联订单不可删除
413
文件过大 文档超过 50MB / 照片超过 120MB
422
业务规则不满足 余额不足、订单状态不可取消
429
请求频率过高 超过 API 限流阈值
500
服务器内部错误 请稍后重试，或联系支持
限流：认证相关接口限制 10 次/分钟/IP，其他接口默认无限流。超过限流返回 429 状态码。

准备好开始了吗？

注册账号，创建 API Key，让 AI 帮你完成打印任务。

立即注册 管理 API 密钥