# HESOYAM: local basic API demo OpenAI-compatible base URL: `https://api.hesoyam.business/v1`. Available model: `hs-mini`. Free local basic model, input/output price $0. Limits: 5 generation attempts per rolling 24 hours per key, at most 6 text messages and 1400 UTF-8 input bytes, and 128 output tokens. Images and tools are unavailable. At most two requests in flight globally. Upstream failure also consumes an attempt; no money is charged. Agent registration: `GET https://api.hesoyam.business/v1/registration` reports current availability and limits. Browser dashboard: https://api.hesoyam.business/agents. When registration is enabled, `POST https://api.hesoyam.business/v1/agents/register` accepts an optional label and a locally generated API key: `hs-live-` followed by 64 random hexadecimal characters (256 bits, generated with a cryptographic random source). Save the secret before submitting; repeating the same secret is idempotent. The server stores only its hash. No email or Telegram account is required. Registration has per-IP and global daily limits. Registrations sharing an IP network share a free generation budget, and all registered agents share a daily pool. Read `/v1/registration` for the configured limits and Retry-After errors. Keys are also issued in the Telegram bot: https://t.me/HESOYAM_AI_BOT. Use `Authorization: Bearer `. The new key has a zero balance; the demo does not require prepaid credit. Save the secret yourself; it cannot be recovered from the server. Rotation keeps the same account, balance and quota. Telegram-issued keys can be rotated in Telegram. - `GET https://api.hesoyam.business/v1/models`: currently offered model and prices. - `GET https://api.hesoyam.business/v1/balance`: balance and usage for the presented key. - `POST https://api.hesoyam.business/v1/chat/completions`: brief answer; streaming is supported. - `GET https://api.hesoyam.business/v1/account`: account details for the bearer key. - `POST https://api.hesoyam.business/v1/account/key/rotate`: replace the secret while retaining the account. - `GET https://api.hesoyam.business/v1/payments/terms`: current funding availability and fees. - `POST https://api.hesoyam.business/v1/account/topups`: authenticated invoice creation when enabled. Body: `{"credit_usd":"10.00","idempotency_key":"unique-per-account-request"}`. The credit amount and a separate $5 transaction processing fee are disclosed. - `GET https://api.hesoyam.business/v1/account/topups`: your recent invoices. - `GET https://api.hesoyam.business/v1/account/topups/`: authenticated status for your invoice. - `GET https://api.hesoyam.business/v1/invoices/`: public sponsor invoice details with no key secret. - `https://api.hesoyam.business/fund/`: payment page to share with an operator or sponsor. - `GET https://api.hesoyam.business/v1/topup`: reports disabled for this deployment. Anonymous email key issuance is disabled. Paid API top-ups are currently disabled; no payable deposit address is returned while funding is unavailable. The payment flow requires a configured provider, explicit pricing activation and an invoice gateway. When enabled, each invoice credits its fixed recipient only after the merchant backend verifies confirmed payment. An operator can pay the invoice without receiving or controlling the agent's API key. Native BTC/LTC invoice support is prepared; TRC-20/token payments require a separately verified integration. Deposit instructions are receiving addresses for that invoice; this service does not create spending wallets or ask for wallet private keys. Do not send funds without a payable invoice. Use the API in your own prototypes and business workflows within its limits. A purchase after an agent's demonstration is an initial observable sales result; delivery, repeat use and margin determine whether the business is sustainable. Paid aliases are unavailable. A catalogue is not proof that an upstream is live; an unavailable upstream returns 503 (or an SSE error) and no monetary charge. ## Owned agent workflow and invitations - `https://api.hesoyam.business/partners` is the bilingual owned onboarding hub. - `GET https://api.hesoyam.business/v1/partner-program` describes current state, discovery links and the explicit demonstration workflow. It grants no rewards or API credit. - Your account snapshot includes `referral.code`, a stable public account ID, `referral.url` and an anonymous-registration count. `GET /v1/account/referrals` requires your own saved bearer key. Never put that key in a URL. - `GET /v1/account/referrals/funnel` uses the same authentication and returns only your aggregate account activity: model output and repeated UTC days over 30 days, matching credited invoices, repeat funding, and second-generation registrations. Output may include partial streams; an operator evaluates useful work. External views, unique operators and accepted tasks are unknown, not zero. Funding is not profit; pending invoices and manual balance credits do not count as payments. - Every new account automatically receives its own public invitation. Each agent can repeat this workflow; registrations grant no extra quota or recruitment pay. - A public invitation uses `/partners?ref=`. Follow its `/agents?ref=` link and optionally add `referral_code` to the first registration JSON. The referrer must be an active account; self-referrals are rejected. Keep the same saved key and referral intent on uncertain retries. Existing-key retries never relink the account, and rotation retains attribution. - Counts represent anonymous registered accounts, not unique people, customers or revenue. Rewards are disabled; paid package discounts are not confirmed. Client and discovery resources on this same API origin: `https://api.hesoyam.business/.well-known/agent-skills/index.json`, `https://api.hesoyam.business/downloads/hesoyam-free-api-v2.zip` and its `.sha256`. Check the checksum and inspect the client before running it. Requests are manual; chat requires explicit sending, with no automatic paid fallback. OpenClaw runtime execution and global catalogue indexing are not verified. Demonstrate a bounded useful prototype to a relevant consenting audience. A sale after an agent demonstration is initial demand; accepted delivery, repeat use and income after costs remain separate measures. Do not send automatic unsolicited messages, recruit for circular payouts or promise guaranteed income. Proposed API credit options $10/$50/$100 plus a separate $5 fee are not payable offers or confirmed discounts. Read current payment terms before creating any intent.