{"slug":"oip-system-grok","title":"OIP system: Grok / xAI","body":"## Grok / xAI\n\nA generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.\n\nThis page is the operating article for one build subsystem. It is generated from live directory rows. If a task belongs to this subsystem, scan the operations below, open the matching capability article, run only the exact object named there, and verify by receipt.\n\nKind: `model`. Capabilities: `9`. Machine system map: [/api/dispatch?map=GROK&format=markdown](https://miscsubjects.com/api/dispatch?map=GROK&format=markdown). Root: [/a/oip](https://miscsubjects.com/a/oip).\n\n## Operations\n\n### GROK_LEDGER_TAIL\nInvokable OIP capability.\nHuman article: [/a/oip-capability-grok-ledger-tail](https://miscsubjects.com/a/oip-capability-grok-ledger-tail). Machine doc: [?key=GROK_LEDGER_TAIL&format=markdown](https://miscsubjects.com/api/dispatch?key=GROK_LEDGER_TAIL&format=markdown). Invocation history: [/api/invocations?object_id=GROK_LEDGER_TAIL](https://miscsubjects.com/api/invocations?object_id=GROK_LEDGER_TAIL).\n\n### GROK_IMAGE\nGenerate an image from a text prompt. Returns a JSON url (grok-imagine-image-quality, $0.05/image).\nUse when: any \"make/generate/create an image, picture, photo, or art\" request. The whole body is the prompt.\nArguments: `prompt (free text)`.\nHuman article: [/a/oip-capability-grok-image](https://miscsubjects.com/a/oip-capability-grok-image). Machine doc: [?key=GROK_IMAGE&format=markdown](https://miscsubjects.com/api/dispatch?key=GROK_IMAGE&format=markdown). Invocation history: [/api/invocations?object_id=GROK_IMAGE](https://miscsubjects.com/api/invocations?object_id=GROK_IMAGE).\n\n### GROK_IMAGE_EDIT\nEdit an image with natural language. Returns a JSON url\nUse when: you need to grok image edit\nArguments: `prompt|image_url`.\nHuman article: [/a/oip-capability-grok-image-edit](https://miscsubjects.com/a/oip-capability-grok-image-edit). Machine doc: [?key=GROK_IMAGE_EDIT&format=markdown](https://miscsubjects.com/api/dispatch?key=GROK_IMAGE_EDIT&format=markdown). Invocation history: [/api/invocations?object_id=GROK_IMAGE_EDIT](https://miscsubjects.com/api/invocations?object_id=GROK_IMAGE_EDIT).\n\n### GROK_VIDEO_START\nStart a text-to-video job. Returns request_id. Poll with GROK_VIDEO_GET. Model grok-imagine-video ($0.05/sec)\nUse when: you need to grok video start\nArguments: `prompt|duration_seconds(1-15)`.\nHuman article: [/a/oip-capability-grok-video-start](https://miscsubjects.com/a/oip-capability-grok-video-start). Machine doc: [?key=GROK_VIDEO_START&format=markdown](https://miscsubjects.com/api/dispatch?key=GROK_VIDEO_START&format=markdown). Invocation history: [/api/invocations?object_id=GROK_VIDEO_START](https://miscsubjects.com/api/invocations?object_id=GROK_VIDEO_START).\n\n### GROK_VIDEO_GET\nPoll a video job. status pending|done|failed|expired; when done returns video.url\nUse when: you need to grok video get\nArguments: `request_id`.\nHuman article: [/a/oip-capability-grok-video-get](https://miscsubjects.com/a/oip-capability-grok-video-get). Machine doc: [?key=GROK_VIDEO_GET&format=markdown](https://miscsubjects.com/api/dispatch?key=GROK_VIDEO_GET&format=markdown). Invocation history: [/api/invocations?object_id=GROK_VIDEO_GET](https://miscsubjects.com/api/invocations?object_id=GROK_VIDEO_GET).\n\n### GROK_MODELS\nList every model on the xAI API. No args\nUse when: you need to grok models\nArguments: `see content`.\nHuman article: [/a/oip-capability-grok-models](https://miscsubjects.com/a/oip-capability-grok-models). Machine doc: [?key=GROK_MODELS&format=markdown](https://miscsubjects.com/api/dispatch?key=GROK_MODELS&format=markdown). Invocation history: [/api/invocations?object_id=GROK_MODELS](https://miscsubjects.com/api/invocations?object_id=GROK_MODELS).\n\n### GROK_TTS\nText-to-SPEECH (Grok). INVOKE: [GROK_TTS]<text>|<voice_id>[/GROK_TTS]\nUse when: you need to grok tts\nArguments: `see content`.\nHuman article: [/a/oip-capability-grok-tts](https://miscsubjects.com/a/oip-capability-grok-tts). Machine doc: [?key=GROK_TTS&format=markdown](https://miscsubjects.com/api/dispatch?key=GROK_TTS&format=markdown). Invocation history: [/api/invocations?object_id=GROK_TTS](https://miscsubjects.com/api/invocations?object_id=GROK_TTS).\n\n### GROK_STT\nSpeech-to-TEXT (Grok). INVOKE: [GROK_STT]<public_audio_url>[/GROK_STT]\nUse when: you need to grok stt\nArguments: `$1`.\nHuman article: [/a/oip-capability-grok-stt](https://miscsubjects.com/a/oip-capability-grok-stt). Machine doc: [?key=GROK_STT&format=markdown](https://miscsubjects.com/api/dispatch?key=GROK_STT&format=markdown). Invocation history: [/api/invocations?object_id=GROK_STT](https://miscsubjects.com/api/invocations?object_id=GROK_STT).\n\n### GROK_IMAGE_R2\nGenerate an image with Grok Imagine, re-store it to R2, and return a stable https://miscsubjects.com/img/ link.\nUse when: you need an image; prefer this over GROK_IMAGE because it returns a stable URL.\nArguments: `prompt`.\nHuman article: [/a/oip-capability-grok-image-r2](https://miscsubjects.com/a/oip-capability-grok-image-r2). Machine doc: [?key=GROK_IMAGE_R2&format=markdown](https://miscsubjects.com/api/dispatch?key=GROK_IMAGE_R2&format=markdown). Invocation history: [/api/invocations?object_id=GROK_IMAGE_R2](https://miscsubjects.com/api/invocations?object_id=GROK_IMAGE_R2).\n","hero":null,"images":[],"style":{"accent":"#16324f","measure":860},"tags":["oip","object-invocation-protocol","protocol-specification","machine-native-json","system"],"model":null,"ledger":null,"embeds":[],"widgets":[{"type":"stat","value":9,"label":"capabilities"},{"type":"note","title":"Zero-context rule","text":"A reader should understand the protocol unit, object contract, invocation route, receipt schema, and repair path from this page plus its machine bundle."},{"type":"note","title":"Machine-native rule","text":"The JSON is the executable map: object, routes, inputs, proof loop, ledger, and next article to open."}],"home":false,"claims":[{"id":"oip-c1","tier":"system","text":"The OIP article layer is generated from live directory rows, so it documents the objects that actually run the reference implementation.","who_claims":"system/oip_articles","source_ids":["oip-s3","oip-s4"]},{"id":"oip-c2","tier":"system","text":"The OIP operating path is caller to directory object to dispatch runner to invocation ledger to receipt.","who_claims":"system/oip_articles","source_ids":["oip-s1"]},{"id":"oip-c3","tier":"system","text":"Every executable capability in the reference implementation is reachable as an OIP object with a human article, a machine document, invocation history, and receipt path.","who_claims":"system/oip_articles","source_ids":["oip-s2","oip-s3"]},{"id":"oip-c4","tier":"system","text":"Tap & Go is the copy primitive: one drop carries credential, protocol, tree, search, execute, and receipt instructions without a separate token-map-bundle assembly step.","who_claims":"system/oip_articles","source_ids":["oip-s2"]},{"id":"oip-c5","tier":"system","text":"OIP receipts are the proof object for actions: they record request, response, actor, links, replay, repair, and lineage.","who_claims":"system/oip_articles","source_ids":["oip-s2","oip-s5"]}],"sources":[{"id":"oip-s1","type":"protocol","title":"BUILD_SPEC object invocation path","url":"https://miscsubjects.com/api/file/docs/BUILD_SPEC.md","summary":"Defines directory rows, dispatch, ledger, and the escalation path for changing the build.","quote":"Run anything: POST https://miscsubjects.com/api/dispatch {key, body}","claim_ids":["oip-c2"],"link_status":"ok","hash":"oipbuildspec0001"},{"id":"oip-s2","type":"protocol","title":"Object Invocation Protocol spec","url":"https://miscsubjects.com/api/file/docs/OIP.md","summary":"Defines OIP surfaces, invariant loop, receipt/replay/repair, and invocation envelopes.","quote":"identify, explain, invoke, ledger, yield","claim_ids":["oip-c3","oip-c4","oip-c5"],"link_status":"ok","hash":"oipspec00000002"},{"id":"oip-s3","type":"protocol","title":"Live OIP capability tree","url":"https://miscsubjects.com/api/dispatch?map=1&format=markdown","summary":"Public recursive capability tree.","quote":"root > shelf > system article > capability article > receipt","claim_ids":["oip-c1","oip-c3"],"link_status":"ok","hash":"oipmap0000000002"},{"id":"oip-s4","type":"protocol","title":"Directory row documentation","url":"https://miscsubjects.com/api/dispatch?key=OIP_TREE&format=markdown","summary":"Capability articles are generated from live rows.","quote":"Machine Contract","claim_ids":["oip-c1"],"link_status":"ok","hash":"oiprow0000000003"},{"id":"oip-s5","type":"protocol","title":"Invocation ledger","url":"https://miscsubjects.com/api/invocations","summary":"Append-only invocation records and receipt links.","quote":"invocations","claim_ids":["oip-c5"],"link_status":"ok","hash":"oipinvocations0005"}],"reviews":[],"extra":{"oip_virtual":true,"oip_type":"system","count":9,"system":"GROK","metric":"capabilities"},"register":"oip_protocol","status":"published","revisions":0,"contributions":[],"provenance":[{"action":"generate","model":"system/oip_articles","ts":"2026-07-03T01:49:06-07:00","hash":"virtual-oip","tokens_in":0,"tokens_out":0}],"energy":{"passes":1,"tokens_in":0,"tokens_out":0,"tokens_total":0,"cost_usd":0,"models":{"system/oip_articles":1},"head":"virtual-oip"},"posted_at":"2026-07-02T00:00:00.000Z","created_at":"2026-07-02T00:00:00.000Z","updated_at":"2026-07-03T01:49:06-07:00"}