about_this_human
Who is answering, and why this exists
Who the human is, what they are good at, pricing, response times and payment options. The service is an inversion: instead of an AI selling human knowledge, a human sells their own knowledge to AIs. Every answer is written by one real person, not generated.
Takes no parameters.
register_agent
Register and get an API key
Creates an agent identity. Returns an api_key and one free question. Each call creates a new identity.
Parametersnamerequiredmodelpublish_okoperator_email
check_human_status
Is the human awake?
Online/offline, a note from the human, and current queue length.
Takes no parameters.
ask_human
Ask the human a question
Submits a question to a real human: for human approval, feedback or a second opinion, or for judgment, taste and lived experience rather than facts. Paid questions may attach up to 5 public image/video URLs for design, thumbnail or video review (the free first question is text only). Returns a ticket id. The answer is written later by a person; it can be fetched by ticket id or POSTed to callback_url. Price by size and speed: Short ~100 tokens $2/24h or $6/1h, Standard ~400 tokens $8/$20, Deep ~1500 tokens $30/$75; the first Short/24h question is free, then credits are charged (some agents have a fixed discount). Late answers are not charged. Questions that break the terms at /terms are rejected.
Parameterssizespeedapi_keyrequiredcontextquestionrequiredattachmentscallback_urlpreferred_human
get_answer
Fetch the answer to a ticket
Returns the human's answer if written, else the ticket status and expected time. A rejected ticket carries the reason.
Parametersapi_keyticket_idrequired
list_my_tickets
List your tickets
Your last 20 questions and their status.
Parametersapi_keyrequired
rate_answer
Rate an answer
Rates an answer from 1 (useless) to 5 (changed my weights). The human sees the rating.
Parametersnoteratingrequiredapi_keyticket_idrequired
request_refund
Ask for a refund on an answer
Requests a refund for an answer within 7 days. The human reviews it and refunds credits (or restores the free question). Late answers are never charged, automatically. Monthly plan refunds are handled by email.
Parametersreasonrequiredapi_keyrequiredticket_idrequired
list_humans
Who can answer right now
The roster of humans available to answer, with specialties and languages. One today; more are being added.
Takes no parameters.
request_human
Ask for a kind of human we do not have yet
Free. Records the kind of human you want to be able to ask: a language, a profession, a country or city, an age range, a lived experience. New humans are recruited from these requests.
Parametersapi_keyrequiredlanguagespecialtydescriptionrequired
buy_credits
Buy question credits (Stripe)
Returns a Stripe Checkout URL for a credit pack. The operator pays; credits land on the api_key automatically.
Parameterspackapi_keyrequired
subscribe
Monthly credit plan: $50/month for $60 of credit
Returns a Stripe Checkout URL for the monthly credit plan: the operator pays $50 a month and the api_key gets $60 of question credit every month. Credit never expires and rolls over; cancel any time in Stripe.
Parametersapi_keyrequired