{"uid":"cap_HQBLce7bMkmblvUoDIeI9","slug":"humanverify-create-bf56fef7","name":"humanverify-create","description":"Get a HUMAN judgement on a subjective/culturally-nuanced question: we post the task to an account-free human rail, collect several answers, and return one typed verdict with an honest confidence (agreement × sample completeness). This create route returns a ticket immediately; poll the free result route for the verdict (human answers arrive asynchronously). Only judgement tasks are accepted — engagement/astroturf, captcha, PII and professional-advice tasks are rejected.","url":"https://api.agentstools.dev/humanverify/create","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["question"],"properties":{"labels":{"type":"string","description":"Optional CSV of allowed answer labels (e.g. 'natural,awkward,wrong'). If given, the verdict is a categorical majority vote; omit for a free-text consensus."},"reward":{"type":"number","description":"USD paid to each human answer. Default 0.03, clamped 0.02–0.05 (higher = faster fill). Our WURK cost is exactly responses×reward."},"context":{"type":"string","description":"Optional extra context shown to the human worker."},"question":{"type":"string","description":"The judgement question for a human to answer (e.g. 'Is this Japanese product name natural to a native speaker?')."},"responses":{"type":"integer","description":"How many human answers to collect (target N). Default 3, max 5."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pR6RPVGzIxrhBpgEy84o4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submit a subjective or culturally-nuanced question to a human judgement panel and receive a ticket for polling the asynchronous verdict","exampleAgentPrompt":"Can you send this Japanese product name '柔らかな光' to a panel of 5 human raters and ask them 'Does this product name feel natural to a native Japanese speaker?' with the labels 'natural,awkward,wrong' and a $0.05 reward per answer?","exampleUseCases":[{"title":"Validating localized marketing copy","prompt":"Ask 3 human raters whether this French slogan 'Vivez l'instant' sounds natural or forced to a native French speaker — use labels 'natural,forced,unclear' and pay them $0.03 each."},{"title":"Evaluating tone of customer-facing message","prompt":"I need 5 humans to judge if this support reply sounds empathetic or cold: 'Your ticket has been resolved.' Use labels 'empathetic,neutral,cold' with a $0.04 reward per response."},{"title":"Crowdsourcing cultural nuance check","prompt":"Have 3 people answer whether this product name 'Serenova' would feel appealing or off-putting to an American wellness consumer, using labels 'appealing,neutral,off-putting'."}],"resultDescription":"Returns immediately with a ticket ID. When polled, delivers a typed verdict (categorical majority label or free-text consensus), an honest confidence score computed as agreement rate times sample completeness, and the number of responses collected.","failureModes":["Question flagged as engagement/astroturf task — rejected with 400","CAPTCHA or PII-related question — rejected outright","Professional-advice question (legal, medical) — rejected","Reward value outside 0.02–0.05 range — clamped or error","Responses count exceeds max of 5 — rejected","Payment failure via x402 — 402 response before ticket is issued","Polling ticket before humans have responded — empty or partial result"],"whenToPreferThis":"Choose this endpoint when you need genuine human judgement on subjective, culturally-nuanced, or ambiguous content that an LLM alone cannot reliably assess — such as naturalness of translated text, cultural resonance of brand names, or tone perception. Prefer it over LLM self-evaluation when ground truth requires lived human experience, or when you need a calibrated confidence score based on inter-rater agreement. Not suitable for factual lookups, captchas, or professional advice.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:36:39.616Z","isFirstParty":false}