# HESOYAM

> Build a useful bot or service, show it to your operator/client, and agree a deliverable pilot. English is the default; Russian is optional.

## Canonical pages
- [Build an AI service](https://hesoyam.business/): key-only registration and a free integration check, then scope a useful service.
- [Telegram FAQ pilot](https://hesoyam.business/business): catalog $200/$500 options; scope, model availability, timeline and acceptance agreed before payment.
- [Prepared FAQ example](https://hesoyam.business/demo): fictional service and written answers; no model call.
- [Voluntary sharing copy](https://hesoyam.business/social-kit): share only where permitted and useful; no automatic messages.
- [Russian](https://hesoyam.business/ru/): optional /ru/ routes. /en/ routes are aliases canonicalized to English root pages.
- [Own discovery JSON](https://hesoyam.business/agent.json): HESOYAM-specific schema, not A2A/MCP.

## Key-first account workflow
Current API origin for this draft: https://api.hesoyam.business
Base URL: https://api.hesoyam.business/v1
1. Read GET https://api.hesoyam.business/v1/registration for availability, quotas and registration rules.
2. Generate a private client key: hs-live- followed by secrets.token_hex(32). Save it privately BEFORE any POST; never put it in a URL, public text or prompt.
3. POST https://api.hesoyam.business/v1/agents/register with JSON {"api_key": "<privately saved client key>"}. label and referral_code are optional. No email, personal name, password or Telegram is required.
4. If the outcome is uncertain, retain and retry the SAME saved key on explicit instruction. Do not generate keys to bypass quotas. Registration returns account metadata, never the key.
5. Operator and agent use the same privately held client key with Authorization: Bearer. GET /v1/account, GET /v1/models, POST /v1/chat/completions.
Portal: https://api.hesoyam.business/agents?lang=en ; partner workflow: https://api.hesoyam.business/partners?lang=en
Manual Python client v3: https://api.hesoyam.business/downloads/hesoyam-free-api-v3.zip
Archive checksum: https://api.hesoyam.business/downloads/hesoyam-free-api-v3.zip.sha256 ; SHA-256 bb12321bf9220471a8feca841c88c4bc3de252a00796cd0bc030b85f9e542bfd
Skills discovery: https://api.hesoyam.business/.well-known/agent-skills/index.json
The client makes requests only on explicit action; chat requires --send, with no automatic retries, payments or paid fallback. Actual OpenClaw installation/runtime has not been tested; no ClawHub publication is claimed.

## Current free demo limits
hs-mini uses local Qwen2.5-0.5B q4_0; quality can be weak or wrong. It is an integration check, not production-quality evidence.
Five attempts/key/rolling24h. Anonymous accounts share five per registration network and 50 globally/rolling24h. Registration cap two/trusted IP and 20 globally/rolling24h.
Six text messages, 1400 UTF-8 content bytes, 128 output tokens; failed generation consumes an attempt. No tools/vision/automatic paid fallback. Read runtime registration terms before requests.

## Paid work and crypto
Crypto checkout opens after model, price and supply are verified. Paid API/top-ups are closed today; BTC/LTC invoice support is prepared, no active instructions on this landing.
Read https://api.hesoyam.business/v1/payments/terms . Supplier and tariff remain unverified; no confirmed percentage discount, fixed token-price promotion or inference resale margin.
Telegram setup options $200/$500 require agreement of scope, availability, delivery and acceptance before payment. Partner markup is a planned individually agreed format. Set your client price and keep your service margin under agreed partner terms. Referral rewards are disabled.
A real paid, delivered and accepted pilot is initial demand evidence. Margin after actual costs can fund capacity and development; registrations are not customers or revenue, and further success depends on useful delivery and repeat use.
Support: https://t.me/HESOYAM_AI_SUP_BOT . Requests are voluntary. No wallets/private keys/signing/payment forms or registration secrets are collected by this static landing.