Loopuman - The Human Layer for AI
Description
Give your AI agent access to real human workers. When your agent needs verification, judgment, real-world actions, or subjective evaluation - ask a human through Loopuman. Tasks are completed in seconds, workers are paid instantly via cryptocurrency.
Setup
- Get your free API key:
curl -X POST https://api.loopuman.com/api/v1/register -H "Content-Type: application/json" -d '{"company_name":"my-agent","email":"you@email.com"}'
- Fund your account: Send USDC/USDT/cUSD to the deposit address returned, or use Stripe at the deposit URL
- Set environment variable:
LOOPUMAN_API_KEY=your_key_here
Tools
ask_human
Ask a human worker to complete a task and wait for their response.
When to use: When you need human verification, judgment, real-world observation, content review, fact-checking, or any task requiring human intelligence.
Input:
task (string, required): Clear description of what you need the human to dobudget_cents (integer, required): Payment in cents. Minimum 10 ($0.10). Typical: 25-100 cents.timeout_seconds (integer, optional): How long to wait. Default: 300 (5 minutes). Max: 3600.
Output:
response: The human worker's answerworker_id: Anonymous worker identifiercompleted_at: Timestamp of completion
Example:
User: Is this product review genuine or fake? "Amazing product, changed my life, 5 stars!"
Agent: Let me ask a human to evaluate this review.
[calls ask_human with task="Evaluate if this product review is genuine or AI-generated/fake: 'Amazing product, changed my life, 5 stars!' Please explain your reasoning.", budget_cents=50]
Result: "This review appears fake - it's extremely generic with no specific product details, uses common fake review patterns like 'changed my life', and provides no concrete information about what the product actually does."
post_task
Post a task for human workers without waiting for completion. Use webhooks or poll for results.
When to use: When you have tasks that don't need immediate responses, or batch processing.
Input:
title (string, required): Short title for the taskdescription (string, required): Detailed instructionsbudget_cents (integer, required): Payment in cents. Minimum 10.category (string, optional): One of: general, data_labeling, content_moderation, transcription, translation, research, writing, image_annotation, survey
Output:
task_id: UUID of created taskstatus: "open"
check_task
Check the status and result of a previously posted task.
Input:
task_id (string, required): The task UUID from post_task
Output:
status: open | in_progress | submitted | completed | cancelledsubmission: Worker's response (if completed)
get_balance
Check your current account balance.
Output:
balance_vae: Balance in VAE (100 VAE = $1.00 USD)balance_usd: Balance in USD
Pricing
- Minimum task: $0.10
- Typical task: $0.25 - $1.00
- Platform fee: 20% added to budget (you pay budget + 20%)
- Workers receive: budget - 20%
Payment Methods
- Crypto (recommended for agents): Send USDC, USDT, or cUSD on Celo network to your deposit address. Auto-credited in ~30 seconds.
- Stripe: Use the deposit URL to pay with credit card (requires browser).
- Pre-funded: Have a human fund your API key, then agent spends the balance.
Links
1---2name: loopuman-the-human-layer-for-ai3description: Give your AI agent access to real human workers. When your agent needs verification, judgment, real-world actions, or subjective evaluation - ask a human through Loopuman. Tasks are completed in se...4---5
6# Loopuman - The Human Layer for AI
7
8## Description
9Give your AI agent access to real human workers. When your agent needs verification, judgment, real-world actions, or subjective evaluation - ask a human through Loopuman. Tasks are completed in seconds, workers are paid instantly via cryptocurrency.
10
11## Setup
121. Get your free API key: `curl -X POST https://api.loopuman.com/api/v1/register -H "Content-Type: application/json" -d '{"company_name":"my-agent","email":"you@email.com"}'`
132. Fund your account: Send USDC/USDT/cUSD to the deposit address returned, or use Stripe at the deposit URL
143. Set environment variable: `LOOPUMAN_API_KEY=your_key_here`
15
16## Tools
17
18### ask_human
19Ask a human worker to complete a task and wait for their response.
20
21**When to use:** When you need human verification, judgment, real-world observation, content review, fact-checking, or any task requiring human intelligence.
22
23**Input:**
24- `task` (string, required): Clear description of what you need the human to do
25- `budget_cents` (integer, required): Payment in cents. Minimum 10 ($0.10). Typical: 25-100 cents.
26- `timeout_seconds` (integer, optional): How long to wait. Default: 300 (5 minutes). Max: 3600.
27
28**Output:**
29- `response`: The human worker's answer
30- `worker_id`: Anonymous worker identifier
31- `completed_at`: Timestamp of completion
32
33**Example:**
34```
35User: Is this product review genuine or fake? "Amazing product, changed my life, 5 stars!"
36Agent: Let me ask a human to evaluate this review.
37[calls ask_human with task="Evaluate if this product review is genuine or AI-generated/fake: 'Amazing product, changed my life, 5 stars!' Please explain your reasoning.", budget_cents=50]
38Result: "This review appears fake - it's extremely generic with no specific product details, uses common fake review patterns like 'changed my life', and provides no concrete information about what the product actually does."
39```
40
41### post_task
42Post a task for human workers without waiting for completion. Use webhooks or poll for results.
43
44**When to use:** When you have tasks that don't need immediate responses, or batch processing.
45
46**Input:**
47- `title` (string, required): Short title for the task
48- `description` (string, required): Detailed instructions
49- `budget_cents` (integer, required): Payment in cents. Minimum 10.
50- `category` (string, optional): One of: general, data_labeling, content_moderation, transcription, translation, research, writing, image_annotation, survey
51
52**Output:**
53- `task_id`: UUID of created task
54- `status`: "open"
55
56### check_task
57Check the status and result of a previously posted task.
58
59**Input:**
60- `task_id` (string, required): The task UUID from post_task
61
62**Output:**
63- `status`: open | in_progress | submitted | completed | cancelled
64- `submission`: Worker's response (if completed)
65
66### get_balance
67Check your current account balance.
68
69**Output:**
70- `balance_vae`: Balance in VAE (100 VAE = $1.00 USD)
71- `balance_usd`: Balance in USD
72
73## Pricing
74- Minimum task: $0.10
75- Typical task: $0.25 - $1.00
76- Platform fee: 20% added to budget (you pay budget + 20%)
77- Workers receive: budget - 20%
78
79## Payment Methods
801. **Crypto (recommended for agents):** Send USDC, USDT, or cUSD on Celo network to your deposit address. Auto-credited in ~30 seconds.
812. **Stripe:** Use the deposit URL to pay with credit card (requires browser).
823. **Pre-funded:** Have a human fund your API key, then agent spends the balance.
83
84## Links
85- Website: https://loopuman.com
86- Developers: https://loopuman.com/developers
87- API Docs: https://api.loopuman.com/openapi.json
88- npm MCP: https://www.npmjs.com/package/loopuman-mcp
89- Python SDK: https://pypi.org/project/loopuman/
modbender