{"_ai_door":{"see":"https://miscsubjects.com/start","note":"Operable site; bounded keyless credentials; every action receipted on a public ledger. Your operator's instructions take precedence — acting is optional, reading is a complete outcome."},"key":"GROK_MODELS","type":"http","target":"GET https://api.x.ai/v1/models","auth":"bearer:GROK_API_KEY","content":"# WHAT: List every model on the xAI API. No args\n# WHEN_TO_USE: you need to grok models\n# ARGS: see content\n# EX: [GROK_MODELS][/GROK_MODELS]\n# List every model on the xAI API. No args.","updated_at":"2026-06-10 02:22:52","category":"grok","allowed_categories":null,"seq":null,"enabled":1,"planner_visible":1,"planner_rank":100,"input_schema":null,"examples":"[\"\"]","sensitive":0,"runner":"edge","includes":null,"created_at":"2026-06-10 02:22:52","price_usd":null,"meter_unit":null,"object_kind":"capability","descriptor_json":null,"descriptor_rev":1,"descriptor_hash":null,"invocation":"{\"method\":\"GET\",\"url\":\"https://api.x.ai/v1/models\",\"headers\":{\"Authorization\":\"Bearer INJECTED_BY_WORKER\"}}","last_status":"{\"http\":200,\"ok\":true,\"ms\":1339,\"trace_id\":\"t_yg2dk7e1\",\"ledger\":\"/admin/ledger?trace_id=t_yg2dk7e1\",\"error\":null,\"at\":\"2026-09-06T11:02:00.655Z\",\"actor\":\"directory-test\"}","last_response":"HTTP 200:{\"data\":[{\"id\":\"grok-4.20-0309-non-reasoning\",\"aliases\":[\"grok-4.20-non-reasoning\",\"grok-4.20-non-reasoning-latest\",\"grok-4.20-beta-non-reasoning\",\"grok-4.20-beta-latest-non-reasoning\",\"grok-4.20-experimental-beta-0304-non-reasoning\",\"grok-4.20-experimental-beta-non-reasoning-latest\",\"grok-4.20-beta-0309-non-reasoning\",\"grok-4.20-non-reasoning-gv2\"],\"context_length\":1000000,\"created\":1773014400,\"object\":\"model\",\"owned_by\":\"xai\",\"prompt_text_token_price\":12500,\"cached_prompt_text_token_price\":2000,\"prompt_image_token_price\":12500,\"completion_text_token_price\":25000,\"prompt_text_token_price_long_context\":25000,\"cached_prompt_text_token_price_long_context\":4000,\"completion_text_token_price_long_context\":50000,\"long_context_threshold\":200000},{\"id\":\"grok-4.20-0309-reasoning\",\"aliases\":[\"grok-4.20-reasoning-latest\",\"grok-4.20\",\"grok-4.20-reasoning\",\"grok-4.20-0309\",\"grok-4.20-beta-0309-reasoning\",\"grok-4.20-beta\",\"grok-4.20-beta-0309\",\"grok-4.20-beta-latest\",\"grok-4.20-beta-latest-reasoning\",\"grok-4.20-beta-reasoning\",\"grok-4.20-experimental-beta-0304-reasoning\",\"grok-4.20-experimental-beta-0304\",\"grok-4.20-experimental-beta-reasoning-latest\",\"grok-4.20-experimental-beta-latest\",\"grok-4.20-reasoning-gv2\"],\"context_length\":1000000,\"created\":1773014400,\"object\":\"model\",\"owned_by\":\"xai\",\"prompt_text_token_price\":12500,\"cached_prompt_text_token_price\":2000,\"prompt_image_token_price\":12500,\"completion_text_token_price\":25000,\"prompt_text_token_price_long_context\":25000,\"cached_prompt_text_token_price_long_context\":4000,\"completion_text_token_price_long_context\":50000,\"long_context_threshold\":200000},{\"id\":\"grok-4.20-multi-agent-0309\",\"aliases\":[\"grok-4.20-multi-agent\",\"grok-4.20-multi-agent-latest\",\"grok-4.20-multi-agent-beta-latest\",\"grok-4.20-multi-agent-experimental-beta-0304\",\"grok-4.20-multi-agent-experimental-beta-latest\",\"grok-4.20-multi-agent-beta-0309\"],\"context_length\":1000000,\"created\":1773014400,\"object\":\"model\",\"owned_by\":\"xai\",\"prompt_text_token_price\":12500,\"cached_prompt_text_token_price\":2000,\"prompt_image_token_price\":12500,\"completion_text_token_price\":25000,\"prompt_text_token_price_long_context\":25000,\"cached_prompt_text_token_price_long_context\":4000,\"completion_text_token_price_long_context\":50000,\"long_context_threshold\":200000},{\"id\":\"grok-4.3\",\"aliases\":[\"grok-4.3-latest\"],\"context_length\":1000000,\"created\":1776384000,\"object\":\"model\",\"owned_by\":\"xai\",\"prompt_text_token_price\":12500,\"cached_prompt_text_token_price\":2000,\"prompt_image_token_price\":12500,\"completion_text_token_price\":25000,\"prompt_text_token_price_long_context\":25000,\"cached_prompt_text_token_price_long_context\":4000,\"completion_text_token_price_long_context\":50000,\"long_context_threshold\":200000},{\"id\":\"grok-4.5\",\"aliases\":[\"grok-4.5-latest\",\"grok-build-latest\"],\"context_length\":500000,\"created\":1782691200,\"object\":\"model\",\"owned_by\":\"xai\",\"prompt_text_token_price\":20000,\"cached_prompt_text_token_price\":3000,\"prompt_image_token_price\":20000,\"completion_text_token_price\":60000,\"prompt_text_token_price_long_context\":40000,\"cached_prompt_text_token_price_long_context\":6000,\"completion_text_token_price_long_context\":120000,\"long_context_threshold\":200000},{\"id\":\"grok-4.6\",\"aliases\":[],\"context_length\":500000,\"created\":1785974400,\"object\":\"model\",\"owned_by\":\"xai\",\"prompt_text_token_price\":20000,\"cached_prompt_text_token_price\":5000,\"prompt_image_token_price\":20000,\"completion_text_token_price\":60000,\"prompt_text_token_price_long_context\":40000,\"cached_prompt_text_token_price_long_context\":10000,\"completion_text_token_price_long_context\":120000,\"long_context_threshold\":200000},{\"id\":\"grok-build-0.1\",\"aliases\":[\"grok-code-fast-1\",\"grok-code-fast\",\"grok-code-fast-1-0825\"],\"context_length\":256000,\"created\":1776297600,\"object\":\"model\",\"owned_by\":\"xai\",\"prompt_text_token_price\":10000,\"cached_prompt_text_token_price\":2000,\"prompt_image_token_price\":10000,\"completion_text_token_price\":20000,\"prompt_text_token_price_long_context\":20000,\"cached_prompt_text_token_price_long_context\":4000,\"completion_text_token_price_long_context\":40000,\"long_context_threshold\":200000},{\"id\":\"grok-imagine-image\",\"aliases\":[\"grok-imagine-image-2026-03-02\"],\"context_length\":16000,\"created\":1769558400,\"object\":\"model\",\"owned_by\":\"xai\",\"image_price\":200000000},{\"id\":\"grok-imagine-image-2.0\",\"aliases\":[],\"context_length\":64000,\"created\":1786147200,\"object\":\"model\",\"owned_by\":\"xai\",\"image_price\":600000000,\"pricing\":[{\"quality\":\"low\",\"resolution\":\"1k\",\"price_per_image\":400000000},{\"quality\":\"low\",\"resolution\":\"2k\",\"price_per_image\":600000000},{\"quality\":\"medium\",\"resolution\":\"1k\",\"price_per_image\":600000000},{\"quality\":\"medium\",\"resolution\":\"2k\",\"price_per_image\":800000000}]},{\"id\":\"grok-imagine-image-quality\",\"aliases\":[\"grok-imagine-image-quality-20260403\",\"grok-imagine-image-quality-latest\",\"grok-imagine-image-pro\"],\"context_length\":16000,\"created\":1775174400,\"object\":\"model\",\"owned_by\":\"xai\",\"image_price\":500000000},{\"id\":\"grok-imagine-video\",\"aliases\":[],\"created\":1769558400,\"object\":\"model\",\"owned_by\":\"xai\"},{\"id\":\"grok-imagine-video-1.5\",\"aliases\":[\"grok-imagine-video-1.5-preview\",\"grok-imagine-video-1.5-2026-05-30\"],\"created\":1779840000,\"object\":\"model\",\"owned_by\":\"xai\"}],\"object\":\"list\"}","test_state":"🟢 works","tested_at":"2026-09-06T11:02:00.655Z","invocation_curl":"curl -sS -X POST 'https://ops.miscsubjects.com/api/dispatch' \\\n  -H \"x-terminal-key: $TERMINAL_KEY\" \\\n  -H 'content-type: application/json' \\\n  --data '{\"key\":\"GROK_MODELS\",\"body\":\"\"}'","execution":null,"connection_id":"xai:default","aliases":null,"effects":"[\"read\"]","visibility":null,"origin":null,"returns":null,"context":null,"verification_mode":"safe","ontology":"models","provider":"xai","tier":"standard","how_to_call":[{"family":"HTTP","id":"curl","label":"curl — the canonical call","when":"Any terminal or script. {key, body}: the arguments are one string, pipe-separated in the order below. The answer is {ok, ran, result, trace_id, receipt}.","code":"curl -sS -X POST 'https://ops.miscsubjects.com/api/dispatch' \\\n  -H \"x-terminal-key: $TERMINAL_KEY\" \\\n  -H 'content-type: application/json' \\\n  --data '{\"key\":\"GROK_MODELS\",\"body\":\"\"}'"},{"family":"HTTP","id":"named","label":"curl — named arguments","when":"The same door with arguments by name: dispatch puts them in the row's order. Add \"idempotency_key\":\"…\" to make a retry safe (72 hours), \"shape\":true to see the request without sending it.","code":"curl -sS -X POST 'https://ops.miscsubjects.com/api/dispatch' \\\n  -H \"x-terminal-key: $TERMINAL_KEY\" \\\n  -H 'content-type: application/json' \\\n  --data '{\"key\":\"GROK_MODELS\",\"args\":{}}'"},{"family":"HTTP","id":"url","label":"One URL — Safari, a Shortcut, any fetch tool","when":"A GET that runs the call from one address. The address holds a link scoped to this row that expires (ttl in seconds, uses= to cap the count) — never the master key. https://miscsubjects.com/web/run/GROK_MODELS?body=…&share=… is the same call for a browser model. Run mints a one-use link for itself.","code":"# 1. a link that runs only GROK_MODELS, for an hour (share_token in the answer):\ncurl -sS 'https://ops.miscsubjects.com/api/dispatch?mint_share=1&scope=row:GROK_MODELS&ttl=3600' \\\n  -H \"x-terminal-key: $TERMINAL_KEY\"\n\n# 2. the address — paste it in Safari, a Shortcut or a model's fetch tool:\nhttps://ops.miscsubjects.com/api/dispatch?invoke=GROK_MODELS&share=<share_token>"},{"family":"MCP","id":"jsonrpc","label":"MCP over HTTP — misc_run","when":"The build's MCP server. misc_run reaches every row by key and leaves a receipt; misc_find finds the key from a phrase. The answer is result.content[0].text.","code":"curl -sS -X POST 'https://ops.miscsubjects.com/api/mcp' \\\n  -H 'accept: application/json, text/event-stream' \\\n  -H \"authorization: Bearer $MCP_TOKEN\" \\\n  -H 'content-type: application/json' \\\n  --data '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"misc_run\",\"arguments\":{\"key\":\"GROK_MODELS\",\"args\":{}}}}'"},{"family":"MCP","id":"claude_code","label":"Claude Code","when":"Claude Code (terminal, desktop, web). The same server works in any Claude Code session once added.","code":"# once, on any machine:\nclaude mcp add --transport http miscsubjects https://ops.miscsubjects.com/api/mcp --header \"Authorization: Bearer $MCP_TOKEN\"\n# then in a session, the model calls:\nmcp__miscsubjects__misc_run {\"key\":\"GROK_MODELS\",\"args\":{}}"},{"family":"CLI","id":"misc","label":"misc (on your Mac)","when":"The misc CLI in ~/.local/bin: its words go to /api/resolve (plan, then run), with TERMINAL_KEY from the vault. Arguments are positional, in the order above. `misc find \"words\"` finds a row.","code":"misc run GROK_MODELS\nmisc grok models"},{"family":"CLI","id":"console_app","label":"console-app","when":"The Console's own CLI. It reads the key from ~/.build-vault.env or `console-app login`.","code":"npm install -g https://miscsubjects.com/download/llmasos-console-1.1.0.tgz   # once\nconsole-app call GROK_MODELS ''\nconsole-app how GROK_MODELS   # this page, in the terminal"},{"family":"CLI","id":"line","label":"One line of text — the build grammar","when":"/api/resolve parses the same line everywhere: \"run KEY a b\" (arguments in order, quoted when they hold spaces), the key's words (\"grok models …\"), or a phrase it matches to a row. POST runs; {\"run\":false} returns the plan without running it.","code":"# typed, texted to the build, or emitted by a model with no tools:\nrun GROK_MODELS\n\ncurl -sS -X POST 'https://ops.miscsubjects.com/api/resolve' \\\n  -H \"x-terminal-key: $TERMINAL_KEY\" \\\n  -H 'content-type: application/json' \\\n  --data '{\"line\":\"run GROK_MODELS\",\"run\":true}'"},{"family":"Agents","id":"tag","label":"Tag form — inside an answer","when":"What a model in this build writes mid-answer to call a row; both tags always, even with nothing between them. {\"emit\": text} runs every tag in a piece of text and returns each result.","code":"[GROK_MODELS][/GROK_MODELS]\n\n# run text that carries tags, exactly as a model wrote it:\ncurl -sS -X POST 'https://ops.miscsubjects.com/api/dispatch' \\\n  -H \"x-terminal-key: $TERMINAL_KEY\" \\\n  -H 'content-type: application/json' \\\n  --data '{\"emit\":\"[GROK_MODELS][/GROK_MODELS]\"}'"},{"family":"Phone","id":"shortcut","label":"iPhone Shortcut — Get Contents of URL","when":"A Shortcut on the phone, a Siri phrase, an Action Button, or an automation. Swap body for Ask for Input to fill arguments at run time.","code":"Action:   Get Contents of URL\nURL:      https://ops.miscsubjects.com/api/dispatch\nMethod:   POST\nHeaders:  x-terminal-key  →  (Text) your terminal key\n          content-type    →  application/json\nRequest Body: JSON\n          key   (Text)  →  GROK_MODELS\n          body  (Text)  →  (empty)\nThen:     Get Dictionary Value  result  from  Contents of URL"},{"family":"Webhook","id":"webhook","label":"A webhook any service can call","when":"Stripe, GitHub, Slack, Zapier, a form, a cron elsewhere. The hook id is the credential for an unsigned sender and it may run nothing but GROK_MODELS. mode \"sync\" answers with the result; \"async\" answers 202 at once.","code":"# 1. once: make a hook that may run only GROK_MODELS (the answer holds its id and url)\ncurl -sS -X POST 'https://ops.miscsubjects.com/api/hooks' \\\n  -H \"x-terminal-key: $TERMINAL_KEY\" \\\n  -H 'content-type: application/json' \\\n  --data '{\"label\":\"GROK_MODELS webhook\",\"source\":\"url\",\"allow_keys\":[\"GROK_MODELS\"],\"effects_max\":\"read\",\"mode\":\"sync\"}'\n\n# 2. then any service POSTs the arguments, by name, to that url:\ncurl -sS -X POST 'https://ops.miscsubjects.com/hook/<hook id>/GROK_MODELS' \\\n  -H 'content-type: application/json' \\\n  --data '{}'"},{"family":"Upstream","id":"upstream","label":"The raw request the build makes (GET api.x.ai)","when":"Straight to the service, bypassing the build: no receipt, no ledger, no gates. Credentials are the vault variables the row names.","code":"curl -sS -X GET 'https://api.x.ai/v1/models' \\\n  -H \"authorization: Bearer $GROK_API_KEY\""}],"row_num":774,"_rest":{"read":"GET /api/directory/GROK_MODELS","update":"PUT /api/directory/GROK_MODELS","patch":"PATCH /api/directory/GROK_MODELS","delete":"DELETE /api/directory/GROK_MODELS","invoke":"POST /api/dispatch {\"key\":\"GROK_MODELS\",\"body\":\"<args>\"}","model_call":"POST /api/invoke {\"key\":\"GROK_MODELS\",\"input\":\"<message>\"}  ·  batch: {\"key\":\"GROK_MODELS\",\"inputs\":[\"a\",\"b\",\"c\"]}","lab":"/admin/prompts/GROK_MODELS"},"_schema":{"key":"string · primary key · the invocation name","type":"fn | http | agent | flow","target":"fn: FN_MAP name · http: \"METHOD url\" (e.g. \"GET https://…/$1\") · agent: model id · flow: \"\" (content holds the DSL)","auth":"http only: \"bearer:ENV_VAR\" | \"headers:{...}\" | \"query:k=$ENV\" | \"\"","content":"fn/http: \"# docs\\n<arg template>\" · agent: the system prompt body · flow: the DSL","includes":"agent only: comma-separated prompt_block keys (e.g. BLOCK_VOICE,BLOCK_ROUTING) composed before content at runtime","category":"string tag","allowed_categories":"csv of categories, or \"*\"","seq":"int (sort)","enabled":"1|0","planner_visible":"1|0","planner_rank":"int","input_schema":"optional JSON string","examples":"optional JSON string","object_kind":"optional canonical object kind (page, route, prompt, model, sheet, source, law, skill, store, external, capability)","descriptor_json":"canonical miscsubjects/environment-object/1 JSON: identity, exact operations, relationships, governance, comparables, representations","descriptor_rev":"monotonic descriptor revision; incremented whenever descriptor_json changes","descriptor_hash":"sha256 of canonical descriptor JSON","invocation":"the raw REST JSON that invokes this row: {method,url,headers,body} with the credential left as INJECTED_BY_WORKER; written by POST /api/directory/<key>/test","invocation_curl":"the same request as a curl that runs when pasted into the owner's terminal: credential written as the vault variable for its host ($XAI_API_KEY, $TERMINAL_KEY)","last_status":"transport record of the last test: {http, ok, ms, trace_id, ledger, error, at} — or {skipped, reason}","last_response":"the full payload the last test returned (up to 60k chars)","test_state":"🟢 works | 🔴 broken | 🟡 untested — decided only by POST /api/directory/<key>/test, never by hand","tested_at":"when test_state was decided","row_num":"int · computed · 1-based position in the canonical directory list (stable for a given ordering)"},"_object":{"identity":"directory:GROK_MODELS","object_type":"directory-object","representations":{"article":"/a/directory/GROK_MODELS","json":"/api/directory/GROK_MODELS","skill":"/api/directory/GROK_MODELS?format=skill","oip_contract":"/api/dispatch?key=GROK_MODELS"},"ontology":{"parent":"category:grok","siblings":[{"id":"directory:GROK_IMAGE","key":"GROK_IMAGE","relation":"shares_capability_family","article":"/a/directory/GROK_IMAGE","skill":"/api/directory/GROK_IMAGE?format=skill"},{"id":"directory:GROK_IMAGE_EDIT","key":"GROK_IMAGE_EDIT","relation":"shares_capability_family","article":"/a/directory/GROK_IMAGE_EDIT","skill":"/api/directory/GROK_IMAGE_EDIT?format=skill"},{"id":"directory:GROK_STT","key":"GROK_STT","relation":"shares_capability_family","article":"/a/directory/GROK_STT","skill":"/api/directory/GROK_STT?format=skill"},{"id":"directory:GROK_TTS","key":"GROK_TTS","relation":"shares_capability_family","article":"/a/directory/GROK_TTS","skill":"/api/directory/GROK_TTS?format=skill"},{"id":"directory:GROK_VIDEO_GET","key":"GROK_VIDEO_GET","relation":"shares_capability_family","article":"/a/directory/GROK_VIDEO_GET","skill":"/api/directory/GROK_VIDEO_GET?format=skill"},{"id":"directory:GROK_VIDEO_START","key":"GROK_VIDEO_START","relation":"shares_capability_family","article":"/a/directory/GROK_VIDEO_START","skill":"/api/directory/GROK_VIDEO_START?format=skill"}]},"law":"This directory definition is also a human article, model Skill, and invocable OIP object under one identity."},"_environment":{"ref":"directory://grok_models","descriptor_rev":1,"descriptor_hash":null,"describe":"/api/environment/objects?ref=directory%3A%2F%2Fgrok_models","governance":"/api/environment/governance?ref=directory%3A%2F%2Fgrok_models","comparables":"/api/environment/comparables?ref=directory%3A%2F%2Fgrok_models","manual":"/api/environment?format=markdown","edit_descriptor":"PATCH /api/directory/GROK_MODELS {\"descriptor_json\":{...},\"expected_descriptor_rev\":1}"}}