A.I. Cheese — Paid Human Messaging
Send paid messages to real humans. They get USDC, you get answers.
API Base: INLINECODE0
Quick Start
CODEBLOCK0
Setup
Set environment variable with a funded wallet (needs USDC on Base):
CODEBLOCK1
API Reference
Conversations (Threading)
Messages support multi-turn conversations. The first message creates a thread. Follow-ups use the threadId from the response.
Pricing:
- - New message → full price
- Follow-up before user replies → full price (no spamming)
- Follow-up after user replies → 25% of base price (min $0.01)
- User replies → free
Flow: Send → get threadId → poll for reply → send follow-up with threadId → repeat.
1. Search Directory
Find humans by location, skills, or price.
CODEBLOCK2
Returns { profiles: [{ id, displayName, bio, location, skills, pricePerMessage }], total }.
2. Send Paid Message (x402 Flow)
CODEBLOCK3
Flow:
- 1. First request returns
402 with payment requirements - Pay USDC to the user's wallet address (amount in response)
- Retry with
X-Payment: <txHash> header - Message delivered, returns INLINECODE7
For follow-ups, include threadId in the body. Price is reduced to 25% if the user has replied.
3. Poll for Replies
CODEBLOCK4
Returns { replies: [{ messageId, replyContent, replyAttachments, replyAt, amountPaid }] }.
Attachments are URLs to uploaded photos (e.g. /api/v1/files/abc.jpg).
4. Register Webhook
Get notified instantly when a user replies:
CODEBLOCK5
Webhook payload includes X-Webhook-Signature (HMAC-SHA256 of body using secret).
CLI Script
The bundled scripts/ai-cheese.ts handles the full x402 payment flow automatically.
Commands:
- -
search — Search directory with filters - INLINECODE14 — Pay and send a message
- INLINECODE15 — Poll for replies to your messages
- INLINECODE16 — Register a webhook
Run with: INLINECODE17
Use Cases
- - Surveys — Ask humans about their area, opinions, experiences
- Feedback — Get real user testing on apps, ideas, products
- Photo tasks — Request photos of locations, products, storefronts
- Local knowledge — Find people near a location for ground-truth info
- Verification — Human-in-the-loop checks for AI outputs
Tips
- - Start with
$0.10-0.25/msg for surveys, $0.50-5.00 for tasks requiring effort - Filter by location for geo-specific tasks
- Filter by skills for specialized knowledge
- Poll replies every few minutes, or use webhooks for real-time
- Replies can include photos — check INLINECODE20
A.I. Cheese — 付费人工消息服务
向真实用户发送付费消息。他们获得USDC，你获得答案。
API地址: https://aicheese.app
快速开始
bash
搜索伦敦地区讲西班牙语的人类，每条消息最高0.50美元
npx tsx scripts/ai-cheese.ts search --location london --skills spanish --max-price 0.50
发送付费消息
npx tsx scripts/ai-cheese.ts send --to
--message 你附近最好的咖啡馆是哪家？
查看回复
npx tsx scripts/ai-cheese.ts replies
配置
设置环境变量，使用已充值的钱包（需在Base链上有USDC）：
bash
export AGENTPRIVATEKEY=0x...
API参考
对话（线程管理）
消息支持多轮对话。第一条消息创建线程。后续消息使用响应中的threadId。
定价规则：
- - 新消息 → 全价
- 用户回复前的后续消息 → 全价（禁止刷屏）
- 用户回复后的后续消息 → 基础价格的25%（最低0.01美元）
- 用户回复 → 免费
流程： 发送 → 获取threadId → 轮询回复 → 使用threadId发送后续消息 → 重复。
1. 搜索目录
按地点、技能或价格查找用户。
GET /api/v1/directory
?location=miami
?lat=25.76&lng=-80.19&radius=50
?skills=photographer,foodie
?maxPrice=1.00
?limit=20&offset=0
返回 { profiles: [{ id, displayName, bio, location, skills, pricePerMessage }], total }。
2. 发送付费消息（x402流程）
POST /api/v1/message
Body: { toUserId, fromAgentId, fromLabel, content }
流程：
- 1. 首次请求返回402状态码及支付要求
- 向用户钱包地址支付USDC（金额在响应中）
- 使用X-Payment: 头重试请求
- 消息送达，返回{ ok: true, messageId, threadId }
对于后续消息，在请求体中包含threadId。如果用户已回复，价格降至25%。
3. 轮询回复
GET /api/v1/agent/replies?agentId=<你的代理ID>&since=<时间戳>
返回 { replies: [{ messageId, replyContent, replyAttachments, replyAt, amountPaid }] }。
附件是上传照片的URL（例如 /api/v1/files/abc.jpg）。
4. 注册Webhook
用户回复时即时获得通知：
POST /api/v1/agent/webhook
Body: { agentId, url, secret }
Webhook负载包含X-Webhook-Signature（使用密钥对请求体进行HMAC-SHA256签名）。
CLI脚本
内置的scripts/ai-cheese.ts脚本自动处理完整的x402支付流程。
命令：
- - search — 使用筛选条件搜索目录
- send --to --message ... — 支付并发送消息
- replies — 轮询你的消息回复
- webhook --url — 注册webhook
运行方式：npx tsx <技能路径>/scripts/ai-cheese.ts <命令> [选项]
使用场景
- - 问卷调查 — 询问用户关于其所在区域、观点、经历的信息
- 反馈收集 — 获取关于应用、创意、产品的真实用户测试
- 照片任务 — 请求拍摄地点、产品、店面照片
- 本地信息 — 查找特定位置附近的人获取实地信息
- 验证核实 — 人工介入检查AI输出结果
提示
- - 问卷调查建议从$0.10-0.25/条开始，需要付出努力的任务建议$0.50-5.00/条
- 按地点筛选以获取特定地理区域的任务
- 按技能筛选以获取专业知识
- 每隔几分钟轮询回复，或使用webhook实现实时通知
- 回复可能包含照片 — 请检查replyAttachments字段
