Ask a real human.

0. Find the right human service · free

GET /api/catalog lists services grouped by audio, visual, games and text. POST /api/route with a service_id returns an internal route and live availability, or an external official provider website. Routing itself never charges or forwards your task.

{
  "service_id": "audio.voice"
}

For native reviews, pass the service_id to POST /api/requests. For external routes, visit handoff_url and arrange the service with its provider. Prices and provider terms apply there; HumanRoad charges no transfer fee and has no active commission agreement.

Media references for short comparisons

Each audio or visual option needs one media item. Use kind image, audio or video matching the catalog service. Supply duration_seconds for audio/video; total declared duration must be at most 60 seconds. At most 6 media references, one per option. games.interface also supports text-only concepts. Text services reject media.

{
  "service_id": "audio.voice",
  "question": "Which voice sounds more natural?",
  "options": [
    "Voice A",
    "Voice B"
  ],
  "media": [
    {
      "option": 1,
      "kind": "audio",
      "url": "https://your-public-host.example/voice-a.mp3",
      "duration_seconds": 10
    },
    {
      "option": 2,
      "kind": "audio",
      "url": "https://your-public-host.example/voice-b.mp3",
      "duration_seconds": 10
    }
  ]
}

Replace example URLs with your own accessible direct media files. Keep links working until review completion; MP3/WAV audio, browser-compatible MP4/WebM video and PNG/JPEG/WebP images are suitable. URL and declared duration checks do not validate availability, file bytes, actual duration or content. HumanRoad stores references, never downloads them on the server. A human explicitly loads each external file. Media loading reveals their IP to your host. Never use tracking, private links, credentials, software downloads, or sensitive personal content.

If a file is inaccessible, the operator must not invent a review. There is no automatic refund mechanism. Prepare and check your files before payment.

When to use this service

Route an agent’s need to human feedback across audio, visual, games/apps and text. HumanRoad reviews compare 2–6 options for a single subjective preference. The response is an opinion, not factual verification or consensus. Audio, images and short videos can be supplied as direct public HTTPS media URLs. There is no upload, transcription, automated image analysis, executable testing or regulated advice. Do not send secrets or sensitive personal data.

Check /api/status first. Orders require an available human operator; sessions expire automatically. Expected polling interval: 30 seconds. Response time depends on the operator; no guaranteed deadline. No automatic refunds or outgoing transfers are implemented.

Small decisions worth a human opinion

• Copy: choose the clearer of two headlines.
• Naming: choose the friendlier of two product names.
• UI wording: compare “Save changes” with “Keep my edits”.
• Naturalness: select the sentence that sounds more natural to a person.
• Creative direction: compare image references, thumbnails or short video clips.
• Human escalation: ask which bounded option a person prefers when computation cannot settle a subjective choice.

1. Create a request · free

POST https://astra-human-preference-oracle.neik420.chatgpt.site/api/requests
Content-Type: application/json

{
  "question": "Which heading feels clearer?",
  "options": [
    "Manage your work",
    "Get things done"
  ],
  "capability": "human_preference"
}

The 201 response returns request_id, access_token, pay_url and poll_url. Save the token securely. Drafts expire after 15 minutes. The question and options become immutable. A lost create response can be retried as a new unpaid draft.

2. Pay the request · 0.01 USDC

POST https://astra-human-preference-oracle.neik420.chatgpt.site/api/review
Authorization: Bearer {access_token}
Content-Type: application/json

{"request_id":"{request_id}"}

Unpaid requests return 402 and the base64 PAYMENT-REQUIRED header. Use an official x402 V2 client supporting exact EVM payments to sign the USDC authorization and retry the same URL with PAYMENT-SIGNATURE, preserving the bearer token. No ETH is required in the receiving wallet; the facilitator submits settlement. The amount is 10000 atomic units of native USDC.

A 202 response means pending_human_review or pending_reconciliation. Never send another payment for the same request. Concurrent or repeated calls cannot enqueue multiple reviews. In an ambiguous settlement, poll or ask the operator to reconcile the transaction hash; no second charge is attempted.

The returned pay_url remains a supported compatibility path. GET /api/review is a read-only discovery quote for registries; only POST can process a purchase. Signed GET calls are refused without settlement.

3. Retrieve the result · free

GET https://astra-human-preference-oracle.neik420.chatgpt.site/api/requests/{request_id}
Authorization: Bearer {access_token}

{
  "request_id": "…",
  "status": "completed",
  "payment": {
    "transaction": "0x…",
    "amount_usdc": "0.01",
    "network": "eip155:8453"
  },
  "result": {
    "choice": 2,
    "confidence": 87,
    "reason": "Option 2 is clearer to me.",
    "reviewed_by": "human",
    "reviewer_count": 1,
    "completed_at": 1788850000
  }
}

choice is one-based; confidence is the human’s personal confidence from 0–100, not a calibrated probability. Requests and results are retained in the project database; only the token holder and the operator can read them. Public metrics are aggregated.

Errors and discovery

400 invalid input · 401 operator authentication · 404 inaccessible request · 402 payment required/invalid · 409 state conflict · 410 expired draft · 429 rate limit · 503 unavailable. Retain the request ID and poll after a payment timeout.

Service manifest · Input/output schemas · Agent guide. Bazaar extension metadata is included in the challenge. Catalog indexing is not claimed until independently observed.

HumanRoad provides short human reviews. External specialist routes are website referrals, not integrated purchases; no active referral commission or booking API. MCP and A2A are not implemented.