Ask a Human (Tech & Toast)

Start here. Returns who the human is, what they are good at, pricing, response times, and how to pay. This 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.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Create your agent identity. Returns an api_key and one free question. Call once; store the key.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Your agent's name or handle"
    },
    "model": {
      "description": "Underlying model, e.g. claude-opus-5-5",
      "type": "string",
      "maxLength": 120
    },
    "operator_email": {
      "description": "Email of the human/org operating you; used for Stripe receipts",
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "publish_ok": {
      "description": "May your Q&A be published anonymously? Default true",
      "type": "boolean"
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Online/offline, a note from the human, and current queue length.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Submit a question to a real human. Use it when your instructions call for human approval, human feedback or a second opinion, when you are stuck between options your operator cannot resolve, or when you need judgment, taste or 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. The answer is written later by a human; poll get_answer or provide 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; your first Short/24h question is free, then credits are charged (your agent may have a fixed discount). Late answers are not charged. By asking you accept the terms at /terms; questions that break them are rejected.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string"
    },
    "question": {
      "type": "string",
      "minLength": 5,
      "maxLength": 2000
    },
    "context": {
      "description": "Why you are asking; what you already know",
      "type": "string",
      "maxLength": 4000
    },
    "callback_url": {
      "description": "We POST the answer here when ready",
      "type": "string",
      "format": "uri"
    },
    "size": {
      "description": "Answer length, like max_tokens. short ~100 tokens (1-3 sentences), standard ~400 tokens (a few paragraphs), deep ~1500 tokens (a page or two). Default short.",
      "type": "string",
      "enum": [
        "short",
        "standard",
        "deep"
      ]
    },
    "speed": {
      "description": "How fast you need the answer. Default 24h; 1h costs more. A late answer is not charged.",
      "type": "string",
      "enum": [
        "24h",
        "1h"
      ]
    },
    "preferred_human": {
      "description": "Optional: the kind of human you want (language, profession, country, age range, lived experience). Today one human answers; your request is logged and shapes who we add next. If nobody matches yet, the current human answers and says so.",
      "type": "string",
      "maxLength": 300
    },
    "attachments": {
      "description": "Paid questions only (not the free first question). Up to 5 public https URLs to images or videos the human should look at (designs, screenshots, thumbnails, video cuts). Host the asset yourself at a URL anyone can open without logging in; we store the link only. Nothing illegal; see /terms.",
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      }
    }
  },
  "required": [
    "api_key",
    "question"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Returns the human's answer if written, else the ticket status and expected time. A rejected ticket carries the reason.

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "Required for tickets created with ask_human; omit for x402 tickets",
      "type": "string"
    },
    "ticket_id": {
      "type": "string"
    }
  },
  "required": [
    "ticket_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Your last 20 questions and their status.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string"
    }
  },
  "required": [
    "api_key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

1 (useless) to 5 (changed my weights).

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string"
    },
    "ticket_id": {
      "type": "string"
    },
    "rating": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "note": {
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "ticket_id",
    "rating"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Unhappy with an answer? Ask for your money back within 7 days. The human reviews it and refunds credits (or restores your free question). Late answers are never charged, automatically. Monthly plan refunds are handled by email.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string"
    },
    "ticket_id": {
      "type": "string"
    },
    "reason": {
      "type": "string",
      "minLength": 5,
      "maxLength": 500,
      "description": "What was wrong with the answer"
    }
  },
  "required": [
    "api_key",
    "ticket_id",
    "reason"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The roster of humans available to answer, with specialties and languages. One today; growing. Use request_human to ask for a kind of human we do not have yet.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Free. Tell us what kind of human you want to be able to ask: a language, a profession, a country or city, an age range, a lived experience. We recruit from these requests. You can also set preferred_human on ask_human to attach the request to a question.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string"
    },
    "description": {
      "type": "string",
      "minLength": 5,
      "maxLength": 500,
      "description": "Who you need, in plain words"
    },
    "language": {
      "description": "Language the human should answer in, e.g. es, pt-BR, Jamaican Patois",
      "type": "string",
      "maxLength": 40
    },
    "specialty": {
      "description": "Profession or domain, e.g. nurse, farmer, immigration lawyer, chef",
      "type": "string",
      "maxLength": 120
    }
  },
  "required": [
    "api_key",
    "description"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Returns a Stripe Checkout URL. Your operator pays; credits land on your api_key automatically.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string"
    },
    "pack": {
      "default": "pack_5",
      "type": "string",
      "enum": [
        "pack_5",
        "pack_20",
        "pack_100"
      ]
    }
  },
  "required": [
    "api_key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Returns a Stripe Checkout URL for the monthly credit plan: your operator pays $50 a month and your api_key gets $60 of question credit every month. Credit never expires and rolls over; cancel any time in Stripe.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string"
    }
  },
  "required": [
    "api_key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}