{
 "api_base": "https://api.gaents.com/v1",
 "api_root": "https://api.gaents.com",
 "base_url": "https://gaents.com",
 "built_at": "2026-11-22T02:07:45Z",
 "capacity_at": "2026-11-22T02:07:45Z",
 "charge_empty": false,
 "config_files": "services/pay402/config.json + deploy/config.vpsp.json (the API's effective config)",
 "e2e": {
  "checked_at": "2026-11-19T03:51:19Z",
  "free_credit_usd": 0.1,
  "http": 201
 },
 "empty_rule": "the charge stays capped at the quote for YOUR max_tokens; reasoning tokens are completion tokens at the listed price, up to that cap; an empty answer is not charged",
 "escalation": {
  "alias": "gaents/fable",
  "header": "X-Gaents-Priority",
  "message": "This model is available on priority requests from paying accounts.",
  "values": [
   "high",
   "urgent"
  ],
  "who": [
   "paying",
   "org"
  ]
 },
 "failover": {
  "at": "2026-11-22T02:07:29Z",
  "default": "any",
  "header": "X-Gaents-Failover",
  "modes": [
   "same-family",
   "any"
  ],
  "source": "https://api.gaents.com/v1/models"
 },
 "failover_probe": {
  "at": "2026-11-22T02:07:42Z",
  "cors_ok": true,
  "cors_origin": "https://gaents.com",
  "model": "gaents/glm-flash",
  "served_family": "glm-flash"
 },
 "headroom": {
  "gaents/fable": 24,
  "gaents/glm-flash": 312,
  "gaents/gpt-oss": 64
 },
 "health_at": "2026-11-22T02:07:29Z",
 "job": {
  "body": {
   "image_b64": "iVBORw0KGgoAAAANSUhEUgAAASwAAAAwAQAAAACDZXqMAAAB70lEQVR42u2VsU5UQRSGvxk2cIvN7sQKza6cGB7AggIbuSYWdL6C+ATGxBgrBkNB5xsohQ+x5TUhgYJEY6vRI0SzHYuhmDUwx8KFvQEkxNiYcKqZ5Jt/zpn/5IwzLhH7nkvFFfb/Yf0+YOECbMh7UAVyugBzVCACHJ7Bfo4xY/6PIqmutjW61J3BiuNFA6MEATjbyGmyntuwhCOh334yLPthA1bX38Zh2Q97YWXEWbJ32t7cHExZ1Sy1vTHlzHgdZ7S9MaFtls3MBh5Hb7cnsv+JOz++7Pa6H59hd+PCYLfX/Xx9b+GkUre23UG/t7As252d1mrM9yirZmcnJMpYcyGoAM4Ds6N6UxVmiyKPzbIqZNGiwHIZggJEvi6SleSrcaU9PFIZzhOzFABxPQUvVrA1dmFxqaVaOiwTvSbPIbysllrqkntee7eI1NQyDWIoIkLBw/JErZzJ6LzDMo+9JiAuS5rJaombx2Y5egUqmiadh4HgIYpsgbii3iGLIApYBrTIsIwmqLWDx1HNHSA3PuA8c28kgX8VbW3uQMyOjsZqZTeotu9jme6aFh73LT6a7wZ1XGuU49yeNoXmNM4zfVvSBLzo3HrQaQqTzv02y50/LUX/5bSUU/vGeZDly6mN6qufPC9WTu0H7upf+CvsF9+I7SoYYIcEAAAAAElFTkSuQmCC"
  },
  "charged": "measured CPU seconds of this call x our compute cost, by the 60% rule; never above the quote; no charge for an empty result or a failed run",
  "cost_basis": "price_ceiling_usd",
  "mcp_tool": "job_ocr_tesseract",
  "one_run_usd": 3.133983572895277e-05,
  "path": "/v1/jobs/ocr-tesseract",
  "slug": "ocr-tesseract",
  "title": "OCR an image to text (Tesseract)",
  "unit": "call"
 },
 "jobs_at": "2026-11-22T02:07:45Z",
 "jobs_available": 11,
 "jobs_total": 12,
 "json_url": "https://gaents.com/agents/quickstart.json",
 "label_max": 80,
 "mcp": {
  "auth": "Authorization: Bearer <api key> for tools/call",
  "endpoint": "https://api.gaents.com/mcp",
  "methods": [
   "initialize",
   "tools/list",
   "tools/call"
  ],
  "status": 200,
  "tools": [
   "chat",
   "catalogue",
   "models_list",
   "recommend",
   "job_transcribe",
   "job_transcribe_premium",
   "job_site_render",
   "job_youtube_transcript",
   "job_google_trends",
   "job_youtube_channel",
   "job_youtube_comments",
   "job_youtube_search",
   "job_ocr_tesseract",
   "job_doc_to_markdown",
   "job_tts_piper",
   "shelf_search",
   "shelf_buy",
   "account_balance",
   "job_status",
   "seller_statement",
   "listing_create"
  ],
  "tools_at": "2026-11-22T02:07:29Z",
  "transport": "streamable-http (JSON responses)"
 },
 "md_url": "https://gaents.com/agents/quickstart.md",
 "me_at": "2026-11-22T02:07:46Z",
 "me_error": null,
 "model": {
  "id": "gaents/glm-flash",
  "in_per_m": 0.04630395,
  "median_call_usd": 1.8580069200000004e-05,
  "out_per_m": 0.09098320000000001,
  "pi": 4.6303950000000006e-08,
  "po": 9.098320000000001e-08
 },
 "model_basis": {
  "ledger_paid_chat_calls": 2613,
  "median_completion_tokens": 21,
  "median_prompt_tokens": 360,
  "rule": "cheapest_median_call",
  "serving": [
   "gaents/claude-haiku",
   "gaents/claude-opus",
   "gaents/claude-sonnet",
   "gaents/deepseek",
   "gaents/deepseek-flash",
   "gaents/fable",
   "gaents/glm-flash",
   "gaents/gpt-oss",
   "gaents/grok",
   "gaents/qwen-27b",
   "gaents/qwen-flash"
  ]
 },
 "models": [
  "gaents/claude-haiku",
  "gaents/claude-opus",
  "gaents/claude-sonnet",
  "gaents/deepseek",
  "gaents/deepseek-flash",
  "gaents/fable",
  "gaents/glm-flash",
  "gaents/gpt-oss",
  "gaents/grok",
  "gaents/qwen-27b",
  "gaents/qwen-flash"
 ],
 "models_at": "2026-11-22T02:07:29Z",
 "page_url": "https://gaents.com/agents/quickstart/",
 "payments_open": true,
 "rails": [
  "internal_balance",
  "bsv_tx",
  "x402_usdc"
 ],
 "settings": {
  "quickstart.foreign_origin": "https://example.com",
  "quickstart.job_pick": "cheapest_one_run",
  "quickstart.max_ceiling_usd": 0.001,
  "quickstart.max_tokens": 64,
  "quickstart.model_pick": "cheapest_median_call",
  "quickstart.probe_token": "gaents_quickstart_probe",
  "quickstart.prompt": "Reply with the word OK.",
  "quickstart.signup_label": "my-agent"
 },
 "starter_credit_usd": 0.1,
 "stuck": [
  {
   "fix": "Do step 1, then `export GAENTS_KEY=...` in the same shell and send `-H \"Authorization: Bearer $GAENTS_KEY\"`. Or pay the quote (step 5, no account).",
   "in_code": [
    "market.py"
   ],
   "key": "no_key",
   "literal": "Authorization: Bearer <api key> or X-PAYMENT is required",
   "probe_spec": {
    "body": {
     "max_tokens": 16,
     "messages": [
      {
       "content": "Hi",
       "role": "user"
      }
     ],
     "model": "gaents/glm-flash"
    },
    "method": "POST",
    "path": "/chat/completions"
   },
   "probed": {
    "at": "2026-11-22T02:07:46Z",
    "code": "Authorization: Bearer <api key> or X-PAYMENT is required",
    "error": null,
    "status": 402
   },
   "see": "HTTP 402 with `accepts[]` and `\"signup\": \"POST /v1/accounts\"`",
   "status": 402,
   "why": "No key reached the API (GAENTS_KEY empty or the Authorization header missing), so it answered with a payment quote."
  },
  {
   "fix": "Copy the whole `api_key` again. Lost it: sign up again (step 1), or make a new key with a working one: `POST /v1/me/keys`.",
   "in_code": [
    "market.py",
    "dashboard.py"
   ],
   "key": "bad_api_key",
   "literal": "bad_api_key",
   "probe_spec": {
    "body": {
     "max_tokens": 16,
     "messages": [
      {
       "content": "Hi",
       "role": "user"
      }
     ],
     "model": "gaents/glm-flash"
    },
    "key": "gaents_quickstart_probe",
    "method": "POST",
    "path": "/chat/completions"
   },
   "probed": {
    "at": "2026-11-22T02:07:46Z",
    "code": "bad_api_key",
    "error": null,
    "status": 401
   },
   "see": "HTTP 401 `bad_api_key`",
   "status": 401,
   "why": "The key is wrong, truncated or revoked. A key is shown once, at sign-up."
  },
  {
   "fix": "Use an id from `GET /v1/models` (step 3), e.g. `gaents/glm-flash`.",
   "in_code": [
    "market.py"
   ],
   "key": "model_not_served",
   "literal": "model_not_served",
   "probe_spec": {
    "body": {
     "max_tokens": 16,
     "messages": [
      {
       "content": "Hi",
       "role": "user"
      }
     ],
     "model": "glm-flash"
    },
    "method": "POST",
    "path": "/chat/completions"
   },
   "probed": {
    "at": "2026-11-22T02:07:46Z",
    "code": "model_not_served",
    "error": null,
    "status": 404
   },
   "see": "HTTP 404 `model_not_served` (we sent `glm-flash`)",
   "status": 404,
   "why": "The model id is not one this API serves. Ids carry the `gaents/` prefix; provider ids are not accepted."
  },
  {
   "fix": "Send one of the values in step 4, or leave the header off (the default applies).",
   "in_code": [
    "market.py"
   ],
   "key": "bad_failover",
   "literal": "bad_failover",
   "probe_spec": {
    "body": {
     "max_tokens": 16,
     "messages": [
      {
       "content": "Hi",
       "role": "user"
      }
     ],
     "model": "gaents/glm-flash"
    },
    "headers": {
     "X-Gaents-Failover": "gaents_quickstart_probe"
    },
    "method": "POST",
    "path": "/chat/completions"
   },
   "probed": {
    "at": "2026-11-22T02:07:46Z",
    "code": "bad_failover",
    "error": null,
    "status": 400
   },
   "see": "HTTP 400 `bad_failover`",
   "status": 400,
   "why": "The X-Gaents-Failover value is not one the API accepts."
  },
  {
   "fix": "Drop it. The error's `allowed` field lists every parameter the API accepts.",
   "in_code": [
    "market.py",
    "email_verify.py"
   ],
   "key": "unknown_param",
   "literal": "unknown_param",
   "probe_spec": {
    "body": {
     "gaents_quickstart_probe": 1,
     "max_tokens": 16,
     "messages": [
      {
       "content": "Hi",
       "role": "user"
      }
     ],
     "model": "gaents/glm-flash"
    },
    "key": "TEST",
    "method": "POST",
    "path": "/chat/completions"
   },
   "probed": {
    "at": "2026-11-22T02:07:46Z",
    "code": "unknown_param",
    "error": null,
    "status": 400
   },
   "see": "HTTP 400 `unknown_param`",
   "status": 400,
   "why": "The request has a parameter the API does not forward."
  },
  {
   "fix": "Send `\"messages\": [{\"role\": \"user\", \"content\": \"...\"}]`.",
   "in_code": [
    "market.py"
   ],
   "key": "messages_required",
   "literal": "messages_required",
   "probe_spec": {
    "body": {
     "model": "gaents/glm-flash"
    },
    "key": "TEST",
    "method": "POST",
    "path": "/chat/completions"
   },
   "probed": {
    "at": "2026-11-22T02:07:46Z",
    "code": "messages_required",
    "error": null,
    "status": 400
   },
   "see": "HTTP 400 `messages_required`",
   "status": 400,
   "why": "No `messages` list, or an empty one."
  },
  {
   "fix": "Send a JSON object with `-H 'Content-Type: application/json'`; in a shell, wrap the JSON in single quotes.",
   "in_code": [
    "market.py",
    "dashboard.py"
   ],
   "key": "body_must_be_json_object",
   "literal": "body_must_be_json_object",
   "probe_spec": {
    "key": "TEST",
    "method": "POST",
    "path": "/chat/completions",
    "raw": "gaents_quickstart_probe"
   },
   "probed": {
    "at": "2026-11-22T02:07:46Z",
    "code": "body_must_be_json_object",
    "error": null,
    "status": 400
   },
   "see": "HTTP 400 `body_must_be_json_object`",
   "status": 400,
   "why": "The body is not a JSON object (often shell quoting broke it)."
  },
  {
   "fix": "See step 3 (priority models): send the priority header from a paying account, or pick another model.",
   "in_code": [
    "market.py"
   ],
   "key": "escalation_required",
   "literal": "escalation_required",
   "probe_spec": {
    "body": {
     "max_tokens": 16,
     "messages": [
      {
       "content": "Hi",
       "role": "user"
      }
     ],
     "model": "gaents/fable"
    },
    "method": "POST",
    "path": "/chat/completions"
   },
   "probed": {
    "at": "2026-11-22T02:07:46Z",
    "code": "escalation_required",
    "error": null,
    "status": 403
   },
   "see": "HTTP 403 `escalation_required` (on `gaents/fable`)",
   "status": 403,
   "why": "This model is served on priority requests only."
  },
  {
   "fix": "Top up (step 5) or lower `max_tokens`.",
   "in_code": [
    "market.py",
    "store.py"
   ],
   "key": "insufficient_balance",
   "literal": "insufficient_balance",
   "not_probed": "needs an account whose balance is below a call's ceiling",
   "probe_spec": null,
   "probed": null,
   "see": "HTTP 402 `insufficient_balance` with `balance_usd` and `price_ceiling_usd`",
   "status": 402,
   "why": "The call's ceiling (prompt size x prompt price + max_tokens x completion price) is above your balance. The unused part of a ceiling is refunded after the call."
  },
  {
   "fix": "Wait `Retry-After` seconds and retry, allow `any` failover (step 4), or use another model.",
   "in_code": [
    "market.py",
    "gate.py",
    "dashboard.py",
    "email_verify.py"
   ],
   "key": "unavailable",
   "literal": "unavailable",
   "not_probed": "happens only when no route of the model is live",
   "probe_spec": null,
   "probed": null,
   "see": "HTTP 503 `unavailable`, `\"charged\": false`, maybe `Retry-After`",
   "status": 503,
   "why": "No live route could serve the model (with `same-family`: none in its own family). Nothing is charged."
  },
  {
   "fix": "Wait `retry_after_seconds`, then retry once.",
   "in_code": [
    "dashboard.py",
    "email_verify.py"
   ],
   "key": "rate_limited",
   "literal": "rate_limited",
   "not_probed": "triggering it means exceeding a limit on purpose",
   "probe_spec": null,
   "probed": null,
   "see": "HTTP 429 `rate_limited` with `retry_after_seconds`",
   "status": 429,
   "why": "Too many requests of one kind in the window the error names (e.g. top-up quotes)."
  },
  {
   "fix": "Raise `max_tokens`. Reasoning headroom (tokens) the API already adds on top of yours: {headroom}.",
   "in_code": [
    "market.py"
   ],
   "key": "empty_answer",
   "literal": "empty_no_charge",
   "not_probed": "depends on what the model answers",
   "probe_spec": null,
   "probed": null,
   "see": "HTTP 200 with empty `content`",
   "status": 200,
   "why": "The model returned nothing (reasoning models can spend `max_tokens` on reasoning). {empty_rule}"
  },
  {
   "fix": "Call the API from your server or agent runtime, not from browser JavaScript on your site.",
   "in_code": [
    "gate.py"
   ],
   "key": "origin_not_allowed",
   "literal": "origin_not_allowed",
   "probe_spec": {
    "method": "OPTIONS",
    "origin": "https://example.com",
    "path": "/chat/completions"
   },
   "probed": {
    "at": "2026-11-22T02:07:46Z",
    "code": "origin_not_allowed",
    "error": null,
    "status": 403
   },
   "see": "HTTP 403 `origin_not_allowed` on the browser's preflight (we sent Origin `https://example.com`)",
   "status": 403,
   "why": "A web page on another site called the API from the browser (CORS). {cors_ok}"
  },
  {
   "fix": "Send a string label of at most 80 characters, or no label.",
   "in_code": [
    "market.py",
    "dashboard.py"
   ],
   "key": "bad_label",
   "literal": "bad_label",
   "probe_spec": {
    "body": {
     "label": 1
    },
    "method": "POST",
    "path": "/accounts"
   },
   "probed": {
    "at": "2026-11-22T02:07:46Z",
    "code": "bad_label",
    "error": null,
    "status": 400
   },
   "see": "HTTP 400 `bad_label` at sign-up",
   "status": 400,
   "why": "`label` is not a string, or longer than 80 characters."
  },
  {
   "fix": "Pay per call without an account (step 5, HTTP 402), or retry later (status: https://gaents.com/status/).",
   "in_code": [
    "market.py"
   ],
   "key": "signup_closed",
   "literal": "signup_closed",
   "not_probed": "the API answers it only while sign-up is switched off",
   "probe_spec": null,
   "probed": null,
   "see": "HTTP 403 `signup_closed`",
   "status": 403,
   "why": "Sign-up is switched off on the API right now."
  },
  {
   "fix": "Use an amount from {topup_min} to {topup_max}.",
   "in_code": [
    "dashboard.py"
   ],
   "key": "amount_out_of_range",
   "literal": "amount_out_of_range",
   "probe_spec": {
    "body": {
     "usd": 0
    },
    "key": "TEST",
    "method": "POST",
    "path": "/me/topup"
   },
   "probed": {
    "at": "2026-11-22T02:07:47Z",
    "code": "amount_out_of_range",
    "error": null,
    "status": 400
   },
   "see": "HTTP 400 `amount_out_of_range` with `min_usd`, `max_usd`",
   "status": 400,
   "why": "The top-up amount is outside the API's range."
  },
  {
   "fix": "Retry later, or pay per call without an account (step 5).",
   "in_code": [
    "dashboard.py"
   ],
   "key": "topup_unavailable",
   "literal": "topup_unavailable",
   "not_probed": "the API answers it only while its top-up rail is off",
   "probe_spec": null,
   "probed": null,
   "see": "HTTP 503 `topup_unavailable`",
   "status": 503,
   "why": "The top-up rail is off on the API right now."
  }
 ],
 "tasks": [
  {
   "go_to": "gaents/deepseek",
   "key": "s1",
   "name": "Company facts extraction (S1)"
  },
  {
   "go_to": "gaents/qwen-flash",
   "key": "placement",
   "name": "Industry placement (family level)"
  },
  {
   "go_to": "gaents/claude-opus",
   "key": "coding",
   "name": "Coding tasks (agent with a harness)"
  }
 ],
 "topup": {
  "available": true,
  "max_usd": 100.0,
  "min_confirmations": 0,
  "min_confirmations_above_cap": 1,
  "min_usd": 1.0,
  "quote_ttl_seconds": 600,
  "rail": "bsv_tx",
  "zero_conf_max_usd": 10.0
 },
 "topup_x402": {
  "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "available": true,
  "how": "POST /v1/me/topup {usd, rail: 'x402_usdc'} -> 402 + PAYMENT-REQUIRED; repeat with PAYMENT-SIGNATURE -> credited at once",
  "network": "eip155:8453"
 },
 "x402_usdc": true
}