{"id":"7f5fe913-0432-4a62-9712-cd97e79be00e","entityType":"agent","slug":"clawhub-runapi-ai-runapi-grok-imagine","name":"grok-imagine","canonicalUrl":"https://www.xpersona.co/agent/clawhub-runapi-ai-runapi-grok-imagine","canonicalPath":"/agent/clawhub-runapi-ai-runapi-grok-imagine","generatedAt":"2026-10-10T21:42:58.614Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T17:02:50.178Z","emptyReason":null},"description":"Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend. Skill: grok-imagine Owner: runapi-ai Summary: Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend. Tags: latest:0.2.12 Version history: v0.2.12 | 2026-08-21T06:59:57.714Z | user Added","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s1771k6pjxksnjws51x2htfjvd876syh:runapi-grok-imagine","sourceUrl":"https://clawhub.ai/runapi-ai/runapi-grok-imagine","homepage":"https://clawhub.ai/runapi-ai/skills/runapi-grok-imagine","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/runapi-ai/runapi-grok-imagine","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/runapi-ai/skills/runapi-grok-imagine","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":62,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Ima"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T17:02:50.178Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T17:02:50.178Z","emptyReason":null},"stars":null,"forks":null,"downloads":1327,"packageName":null,"latestVersion":"0.2.12","tractionLabel":"1.3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T17:02:50.178Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T17:02:50.178Z","lastCrawledAt":"2026-10-10T17:02:50.178Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T17:02:50.178Z","lastVerifiedAt":null,"highlights":[{"version":"0.2.12","createdAt":"2026-08-21T06:59:57.714Z","changelog":"## Added - Document Image 2.0 text-to-image, segment-map, and segment-backed image editing workflows.","fileCount":3,"zipByteSize":4738},{"version":"0.2.11","createdAt":"2026-08-12T06:08:30.168Z","changelog":"## Changed - Generate the grok-imagine skill from the shared RunAPI recipe with contract-discovered request rules and task behavior, direct local media inputs, complete result verification, and bounded recovery.","fileCount":3,"zipByteSize":4726},{"version":"0.2.10","createdAt":"2026-08-10T14:04:30.515Z","changelog":"## Changed - Complete marketplace distribution for the RunAPI Grok Imagine skill.","fileCount":3,"zipByteSize":3353},{"version":"0.2.9","createdAt":"2026-07-17T10:24:02.258Z","changelog":"## Changed - Add the Fast video variant to Grok Imagine skill routing and references.","fileCount":3,"zipByteSize":3426},{"version":"0.2.8","createdAt":"2026-07-16T04:01:40.095Z","changelog":"## Changed - Refresh the Grok Imagine agent skill and public copy for image and video workflows, including the Video 1.5 Preview variant.","fileCount":3,"zipByteSize":3304},{"version":"0.2.4","createdAt":"2026-05-22T09:14:50.505Z","changelog":"Agent-facing CLI-first redesign","fileCount":3,"zipByteSize":2572}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1771k6pjxksnjws51x2htfjvd876syh:runapi-grok-imagine","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-grok-imagine/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-grok-imagine/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-grok-imagine/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-grok-imagine/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-grok-imagine/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-grok-imagine/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T21:42:58.613Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-grok-imagine/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-grok-imagine/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-grok-imagine/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-grok-imagine/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T17:02:50.178Z","emptyReason":null},"readme":"Skill: grok-imagine\n\nOwner: runapi-ai\n\nSummary: Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.\n\nTags: latest:0.2.12\n\nVersion history:\n\nv0.2.12 | 2026-08-21T06:59:57.714Z | user\n\n## Added\n- Document Image 2.0 text-to-image, segment-map, and segment-backed image editing workflows.\n\nv0.2.11 | 2026-08-12T06:08:30.168Z | user\n\n## Changed\n- Generate the grok-imagine skill from the shared RunAPI recipe with contract-discovered request rules and task behavior, direct local media inputs, complete result verification, and bounded recovery.\n\nv0.2.10 | 2026-08-10T14:04:30.515Z | user\n\n## Changed\n- Complete marketplace distribution for the RunAPI Grok Imagine skill.\n\nv0.2.9 | 2026-07-17T10:24:02.258Z | user\n\n## Changed\n- Add the Fast video variant to Grok Imagine skill routing and references.\n\nv0.2.8 | 2026-07-16T04:01:40.095Z | user\n\n## Changed\n- Refresh the Grok Imagine agent skill and public copy for image and video workflows, including the Video 1.5 Preview variant.\n\nv0.2.4 | 2026-05-22T09:14:50.505Z | user\n\nAgent-facing CLI-first redesign\n\nArchive index:\n\nArchive v0.2.12: 3 files, 4738 bytes\n\nFiles: skill-card.md (2905b), SKILL.md (7575b), _meta.json (139b)\n\nFile v0.2.12:SKILL.md\n\n---\nname: grok-imagine\ndescription: \"Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.\"\ndocumentation: https://runapi.ai/models/grok-imagine.md\nprovider_page: https://runapi.ai/providers/xai.md\ncatalog: https://runapi.ai/models.md\nmetadata:\n  openclaw:\n    homepage: https://runapi.ai/models/grok-imagine\n    requires:\n      bins:\n      - runapi\n    install:\n    - kind: brew\n      formula: runapi-ai/tap/runapi\n      bins:\n      - runapi\n    envVars:\n    - name: RUNAPI_API_KEY\n      required: false\n      description: Optional RunAPI API key; agents should prefer environment auth or saved CLI config. Browser login is interactive fallback only.\n---\n\n# Grok Imagine on RunAPI\n\n## Choose route\n\n- For a one-off artifact or result, use the registered `grok-imagine` service in the `runapi` CLI. If the installed command catalog does not list it, stop and report the missing service instead of inventing a command.\n- For an app, backend, worker, library, webhook pipeline, or production codebase, go directly to **Integrate with SDK**. Never shell out to the CLI as the production runtime.\n\n## Discover contract\n\nAuthenticate, then inspect the installed command catalog and the selected operation's current contract:\n\n```shell\nrunapi auth status > auth.json\njq -e '.authenticated == true' auth.json\nrunapi grok-imagine --help\nrunapi grok-imagine <operation> --help\ncurl --fail --location https://runapi.ai/docs/api/grok-imagine/<operation>.md --output contract.md\n```\n\nIf authentication is false, stop before submitting. Ask the user to provide a valid `RUNAPI_API_KEY`, or import a user-provided key from stdin with `runapi auth import-token --token -`; use interactive browser login only when the user explicitly requests it. Choose `<operation>` only from service help. Treat command help as authoritative for the installed operation, model, and top-level field roster. Treat its API Reference as authoritative for the complete request schema, nested fields, conditional rules, task behavior, and response variants. If the two surfaces disagree, stop and report the contract mismatch instead of guessing.\n\n## Build request\n\nCreate `request.json` as valid JSON using only fields accepted by the discovered operation contract. For the chosen model and values, evaluate every applicable conditional rule as a set: satisfy every required field, omit every forbidden field, and stop on unresolved contradictions.\n\nTraverse nested objects and arrays before execution. Close every relationship stated by the discovered contract, including uniqueness constraints and cross-references between nested values.\n\nFor a discovered local media input, including file-typed fields and top-level media URL fields, put an agent-readable local file path directly in `request.json`. The CLI consumes file fields as declared and uploads local paths in top-level media URL fields. Use `runapi files create` only when the user needs a reusable URL, provides Base64, or the discovered contract explicitly requires a separate upload.\n\nValidate the file before sending it:\n\n```shell\njq empty request.json\n```\n\n## Execute\n\nSubmit exactly once and persist the task response before waiting:\n\n```shell\nrunapi grok-imagine <operation> --async --input-file request.json > task.json\ntask_id=\"$(jq -er '.id' task.json)\"\n```\n\nFor a one-off result, immediately wait for that same task and save the complete JSON response. This blocking wait is the default:\n\n```shell\nrunapi wait \"$task_id\" --service grok-imagine --action <operation> > result.json\n```\n\nOnly when the user explicitly asks for background execution, polling, or webhook integration may you stop after validating `task.json`. Report the task id and do not claim that the deliverable is complete.\n\n## Verify\n\nA success status is not the deliverable. Read and validate the complete response according to the discovered result contract. Preserve the complete non-media result in the exact requested format, including JSON, text, SRT, or VTT.\n\nFor every requested media deliverable listed anywhere in the response, download all of them rather than returning only the first URL. Before downloading, derive its expected MIME type or family from response metadata when present, then the selected output format, then an unambiguous result field such as `videos`, `images`, or `audios` in the API Reference. The Catalog-declared fallback families for this skill are `image/*` or `video/*`. Stop only when no single expected type or family can be established from those sources.\n\nFor every downloaded file, require both a non-empty file and the expected MIME type or family:\n\n```shell\ncurl --fail --location <deliverable-url> --output <downloaded-file>\nfor file in <downloaded-files>; do\n  expected_mime=<expected-MIME-or-family-pattern-for-this-file>\n  test -s \"$file\"\n  [[ \"$(file --brief --mime-type \"$file\")\" == $expected_mime ]]\ndone\n```\n\nDo not report completion when any requested deliverable is missing, empty, or has an unexpected MIME type. Record `Skill Conformance` separately from `Task Outcome` so a service failure does not hide whether this recipe was followed.\n\n## Recover or stop\n\n- Correct a request shape at most once, and only when the discovered contract or returned validation error identifies the correction.\n- Retry a transient transport failure at most once, and only when evidence confirms that no task was created, no billing occurred, and retrying is safe.\n- If waiting times out or loses transport after `task.json` exists, preserve the error and rerun `runapi wait` for that same task at most once. Never submit a replacement task.\n- On a terminal RunAPI or service failure, preserve the task/error evidence and stop. Keep the selected model and capability, and do not submit another paid request without user authorization.\n- If the contract is missing a fact required to build or verify the request, stop and report the contract gap. Do not turn a product defect into a permanent skill workaround.\n\n## Integrate with SDK\n\nUse this route only for application or production-code integration. Open the current RunAPI SDK reference below, select the package for the target language and `Grok Imagine`, and confirm its install command, client methods, request types, response types, and error classes before coding. Build the request from the same discovered product contract and apply the same deliverable verification and stop rules. Do not invoke `runapi` as a subprocess from production code.\n\n## References\n\n- Model overview, pricing, and rate limits: https://runapi.ai/models/grok-imagine.md\n- Provider overview: https://runapi.ai/providers/xai.md\n- Full model catalog: https://runapi.ai/models.md\n- SDK integration: https://github.com/runapi-ai/grok-imagine-sdk\n\n## Variants\n- `grok-imagine-edit-image`: https://runapi.ai/models/grok-imagine/edit-image.md\n- `grok-imagine-image-2-0`: https://runapi.ai/models/grok-imagine/image-2-0.md\n- `grok-imagine-image-to-video`: https://runapi.ai/models/grok-imagine/image-to-video.md\n- `grok-imagine-text-to-image`: https://runapi.ai/models/grok-imagine/text-to-image.md\n- `grok-imagine-text-to-video`: https://runapi.ai/models/grok-imagine/text-to-video.md\n- `grok-imagine-video-1.5-fast`: https://runapi.ai/models/grok-imagine/video-1.5-fast.md\n- `grok-imagine-video-1.5-preview`: https://runapi.ai/models/grok-imagine/video-1.5-preview.md\n\nFile v0.2.12:_meta.json\n\n{\n  \"ownerId\": \"kn70me4rk7jqjt92evshjeb5z18768g7\",\n  \"slug\": \"runapi-grok-imagine\",\n  \"version\": \"0.2.12\",\n  \"publishedAt\": 1787295597714\n}\n\nFile v0.2.12:skill-card.md\n\n## Description:\n\nGenerate and edit images and videos with Grok Imagine through RunAPI.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[runapi-ai](https://clawhub.ai/user/runapi-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and external users use this skill to guide agents through one-off Grok Imagine image and video generation, media editing, and SDK integration through RunAPI.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The RunAPI CLI may make authenticated and billable service requests.\n\nMitigation: Use the skill only when RunAPI/Grok Imagine usage is intended, authenticate with approved credentials, and preserve task responses before waiting or retrying.\n\nRisk: Generated media files are downloaded from remote service responses and may be unsafe to open blindly.\n\nMitigation: Treat downloaded outputs as untrusted media files and verify that each file is non-empty and has the expected MIME type before reporting completion.\n\nRisk: Supplying unsupported request fields or guessing missing contract details can lead to failed or unintended service requests.\n\nMitigation: Inspect the installed command help and current API reference, build requests only from accepted fields, and stop when the contract is missing or contradictory.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/runapi-ai/skills/runapi-grok-imagine)\n- [RunAPI Grok Imagine homepage](https://runapi.ai/models/grok-imagine)\n- [Grok Imagine model documentation](https://runapi.ai/models/grok-imagine.md)\n- [xAI provider documentation](https://runapi.ai/providers/xai.md)\n- [RunAPI model catalog](https://runapi.ai/models.md)\n- [Grok Imagine SDK integration](https://github.com/runapi-ai/grok-imagine-sdk)\n- [Edit image variant](https://runapi.ai/models/grok-imagine/edit-image.md)\n- [Image 2.0 variant](https://runapi.ai/models/grok-imagine/image-2-0.md)\n- [Image-to-video variant](https://runapi.ai/models/grok-imagine/image-to-video.md)\n- [Text-to-image variant](https://runapi.ai/models/grok-imagine/text-to-image.md)\n- [Text-to-video variant](https://runapi.ai/models/grok-imagine/text-to-video.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown with inline shell commands, JSON request examples, and integration guidance]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Guides agents to create request JSON, execute RunAPI CLI or SDK workflows, and verify downloaded image or video files.]\n\n## Skill Version(s):\n\n0.2.12 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v0.2.11: 3 files, 4726 bytes\n\nFiles: skill-card.md (2658b), SKILL.md (7496b), _meta.json (139b)\n\nFile v0.2.11:SKILL.md\n\n---\nname: grok-imagine\ndescription: \"Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.\"\ndocumentation: https://runapi.ai/models/grok-imagine.md\nprovider_page: https://runapi.ai/providers/xai.md\ncatalog: https://runapi.ai/models.md\nmetadata:\n  openclaw:\n    homepage: https://runapi.ai/models/grok-imagine\n    requires:\n      bins:\n      - runapi\n    install:\n    - kind: brew\n      formula: runapi-ai/tap/runapi\n      bins:\n      - runapi\n    envVars:\n    - name: RUNAPI_API_KEY\n      required: false\n      description: Optional RunAPI API key; agents should prefer environment auth or saved CLI config. Browser login is interactive fallback only.\n---\n\n# Grok Imagine on RunAPI\n\n## Choose route\n\n- For a one-off artifact or result, use the registered `grok-imagine` service in the `runapi` CLI. If the installed command catalog does not list it, stop and report the missing service instead of inventing a command.\n- For an app, backend, worker, library, webhook pipeline, or production codebase, go directly to **Integrate with SDK**. Never shell out to the CLI as the production runtime.\n\n## Discover contract\n\nAuthenticate, then inspect the installed command catalog and the selected operation's current contract:\n\n```shell\nrunapi auth status > auth.json\njq -e '.authenticated == true' auth.json\nrunapi grok-imagine --help\nrunapi grok-imagine <operation> --help\ncurl --fail --location https://runapi.ai/docs/api/grok-imagine/<operation>.md --output contract.md\n```\n\nIf authentication is false, stop before submitting. Ask the user to provide a valid `RUNAPI_API_KEY`, or import a user-provided key from stdin with `runapi auth import-token --token -`; use interactive browser login only when the user explicitly requests it. Choose `<operation>` only from service help. Treat command help as authoritative for the installed operation, model, and top-level field roster. Treat its API Reference as authoritative for the complete request schema, nested fields, conditional rules, task behavior, and response variants. If the two surfaces disagree, stop and report the contract mismatch instead of guessing.\n\n## Build request\n\nCreate `request.json` as valid JSON using only fields accepted by the discovered operation contract. For the chosen model and values, evaluate every applicable conditional rule as a set: satisfy every required field, omit every forbidden field, and stop on unresolved contradictions.\n\nTraverse nested objects and arrays before execution. Close every relationship stated by the discovered contract, including uniqueness constraints and cross-references between nested values.\n\nFor a discovered local media input, including file-typed fields and top-level media URL fields, put an agent-readable local file path directly in `request.json`. The CLI consumes file fields as declared and uploads local paths in top-level media URL fields. Use `runapi files create` only when the user needs a reusable URL, provides Base64, or the discovered contract explicitly requires a separate upload.\n\nValidate the file before sending it:\n\n```shell\njq empty request.json\n```\n\n## Execute\n\nSubmit exactly once and persist the task response before waiting:\n\n```shell\nrunapi grok-imagine <operation> --async --input-file request.json > task.json\ntask_id=\"$(jq -er '.id' task.json)\"\n```\n\nFor a one-off result, immediately wait for that same task and save the complete JSON response. This blocking wait is the default:\n\n```shell\nrunapi wait \"$task_id\" --service grok-imagine --action <operation> > result.json\n```\n\nOnly when the user explicitly asks for background execution, polling, or webhook integration may you stop after validating `task.json`. Report the task id and do not claim that the deliverable is complete.\n\n## Verify\n\nA success status is not the deliverable. Read and validate the complete response according to the discovered result contract. Preserve the complete non-media result in the exact requested format, including JSON, text, SRT, or VTT.\n\nFor every requested media deliverable listed anywhere in the response, download all of them rather than returning only the first URL. Before downloading, derive its expected MIME type or family from response metadata when present, then the selected output format, then an unambiguous result field such as `videos`, `images`, or `audios` in the API Reference. The Catalog-declared fallback families for this skill are `image/*` or `video/*`. Stop only when no single expected type or family can be established from those sources.\n\nFor every downloaded file, require both a non-empty file and the expected MIME type or family:\n\n```shell\ncurl --fail --location <deliverable-url> --output <downloaded-file>\nfor file in <downloaded-files>; do\n  expected_mime=<expected-MIME-or-family-pattern-for-this-file>\n  test -s \"$file\"\n  [[ \"$(file --brief --mime-type \"$file\")\" == $expected_mime ]]\ndone\n```\n\nDo not report completion when any requested deliverable is missing, empty, or has an unexpected MIME type. Record `Skill Conformance` separately from `Task Outcome` so a service failure does not hide whether this recipe was followed.\n\n## Recover or stop\n\n- Correct a request shape at most once, and only when the discovered contract or returned validation error identifies the correction.\n- Retry a transient transport failure at most once, and only when evidence confirms that no task was created, no billing occurred, and retrying is safe.\n- If waiting times out or loses transport after `task.json` exists, preserve the error and rerun `runapi wait` for that same task at most once. Never submit a replacement task.\n- On a terminal RunAPI or service failure, preserve the task/error evidence and stop. Keep the selected model and capability, and do not submit another paid request without user authorization.\n- If the contract is missing a fact required to build or verify the request, stop and report the contract gap. Do not turn a product defect into a permanent skill workaround.\n\n## Integrate with SDK\n\nUse this route only for application or production-code integration. Open the current RunAPI SDK reference below, select the package for the target language and `Grok Imagine`, and confirm its install command, client methods, request types, response types, and error classes before coding. Build the request from the same discovered product contract and apply the same deliverable verification and stop rules. Do not invoke `runapi` as a subprocess from production code.\n\n## References\n\n- Model overview, pricing, and rate limits: https://runapi.ai/models/grok-imagine.md\n- Provider overview: https://runapi.ai/providers/xai.md\n- Full model catalog: https://runapi.ai/models.md\n- SDK integration: https://github.com/runapi-ai/grok-imagine-sdk\n\n## Variants\n- `grok-imagine-edit-image`: https://runapi.ai/models/grok-imagine/edit-image.md\n- `grok-imagine-image-to-video`: https://runapi.ai/models/grok-imagine/image-to-video.md\n- `grok-imagine-text-to-image`: https://runapi.ai/models/grok-imagine/text-to-image.md\n- `grok-imagine-text-to-video`: https://runapi.ai/models/grok-imagine/text-to-video.md\n- `grok-imagine-video-1.5-fast`: https://runapi.ai/models/grok-imagine/video-1.5-fast.md\n- `grok-imagine-video-1.5-preview`: https://runapi.ai/models/grok-imagine/video-1.5-preview.md\n\nFile v0.2.11:_meta.json\n\n{\n  \"ownerId\": \"kn70me4rk7jqjt92evshjeb5z18768g7\",\n  \"slug\": \"runapi-grok-imagine\",\n  \"version\": \"0.2.11\",\n  \"publishedAt\": 1786514910168\n}\n\nFile v0.2.11:skill-card.md\n\n## Description:\n\nGenerate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[runapi-ai](https://clawhub.ai/user/runapi-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users, developers, and agents use this skill to generate, edit, animate, or transform images and videos with Grok Imagine through RunAPI. It supports one-off CLI execution and SDK-based application or backend integration.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Prompts and selected media files are sent to RunAPI/Grok Imagine and may include sensitive or proprietary content.\n\nMitigation: Use only media intended for upload, review requests before submission, and prefer a dedicated API key where possible.\n\nRisk: Using the skill may consume paid API credits.\n\nMitigation: Authenticate before execution, submit each paid task once, preserve task evidence, and avoid replacement submissions without user authorization.\n\nRisk: A stale CLI or API contract can lead to invalid requests or incomplete deliverables.\n\nMitigation: Discover the current CLI and API contracts, stop on contract mismatches, and verify every requested media file is non-empty with the expected MIME type.\n\n## Reference(s):\n\n- [RunAPI Grok Imagine homepage](https://runapi.ai/models/grok-imagine)\n- [Model overview, pricing, and rate limits](https://runapi.ai/models/grok-imagine.md)\n- [Provider overview](https://runapi.ai/providers/xai.md)\n- [Full model catalog](https://runapi.ai/models.md)\n- [SDK integration](https://github.com/runapi-ai/grok-imagine-sdk)\n- [ClawHub skill page](https://clawhub.ai/runapi-ai/skills/runapi-grok-imagine)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Configuration, Code]\n\n**Output Format:** [Markdown guidance with shell commands, JSON request and response files, and optional SDK code]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May produce request.json, task.json, result.json, downloaded image or video files, and SDK integration snippets.]\n\n## Skill Version(s):\n\n0.2.11 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v0.2.10: 3 files, 3353 bytes\n\nFiles: skill-card.md (2818b), SKILL.md (4182b), _meta.json (139b)\n\nFile v0.2.10:SKILL.md\n\n---\nname: grok-imagine\ndescription: Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.\ndocumentation: https://runapi.ai/models/grok-imagine.md\nprovider_page: https://runapi.ai/providers/xai.md\ncatalog: https://runapi.ai/models.md\nmetadata:\n  openclaw:\n    homepage: https://runapi.ai/models/grok-imagine\n    requires:\n      bins:\n      - runapi\n    install:\n    - kind: brew\n      formula: runapi-ai/tap/runapi\n      bins:\n      - runapi\n    envVars:\n    - name: RUNAPI_API_KEY\n      required: false\n      description: Optional RunAPI API key; agents should prefer environment auth or saved CLI config. Browser login is interactive fallback only.\n---\n\n# Grok Imagine on RunAPI\n\nGenerate and edit images and videos with Grok Imagine through RunAPI. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.\n\n## Critical: Integration Runtime\n\n- Integration work (app, backend, worker, library, Rails service, Node service, Go service, webhook pipeline, or production codebase) uses the **SDK integration path** for the target language.\n- One-off generation, editing, transformation, manual smoke tests, debugging, or user-requested CLI runs use the **CLI path** with the `runapi` binary. For full CLI-specific agent guidance, see https://github.com/runapi-ai/cli-skill.\n- Never shell out to the `runapi` CLI as the production runtime integration layer.\n\n## SDK integration path\n\nWhen integrating Grok Imagine into an app, backend, worker, library, Rails service, Node service, Go service, webhook pipeline, or production workflow, start by checking the current SDK package and official usage. Confirm install commands, client methods (`create`, `get`, `run`), request fields, response shape, and error classes before using CLI help or raw HTTP examples. Use a RunAPI SDK package:\n\n- JavaScript / TypeScript: `@runapi.ai/grok-imagine`\n- Python: `runapi-grok-imagine`\n- Ruby: `runapi-grok-imagine`\n- Go: `github.com/runapi-ai/grok-imagine-sdk/go`\n- Java: `ai.runapi:runapi-grok-imagine`\n- PHP: `runapi-ai/grok-imagine`\n\n## CLI path\n\nThe `runapi` binary is the one-off and manual testing runtime dependency. For full CLI-specific agent guidance, see https://github.com/runapi-ai/cli-skill. Run `runapi auth status` first. For agents and headless runs, prefer `RUNAPI_API_KEY` or import it into saved config with `printf '%s' \"$RUNAPI_API_KEY\" | runapi auth import-token --token -`. Use `runapi login` only when the user explicitly wants interactive browser auth.\n\nInspect the available commands and request fields with CLI help:\n\n```shell\nrunapi grok-imagine --help\nrunapi grok-imagine text-to-video --help\n```\n\nRun a one-off task (synchronous — polls until the task completes):\n\n```shell\nrunapi grok-imagine text-to-video --input-file request.json\n```\n\nSubmit asynchronously and poll separately:\n\n```shell\nrunapi grok-imagine text-to-video --async --input-file request.json\nrunapi wait <task-id> --service grok-imagine --action text-to-video\n```\n\nAvailable commands: `text-to-video`, `image-to-video`, `text-to-image`, `edit-image`, `extend`, `upscale-image`.\n\n## Generated file storage\n\nRunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.\n\n## References\n\n- Model overview, pricing, and rate limits: https://runapi.ai/models/grok-imagine.md\n- Full model catalog: https://runapi.ai/models.md\n\n## Variants\n\n- [Video 1.5 Fast](https://runapi.ai/models/grok-imagine/video-1.5-fast.md)\n- [Video 1.5 Preview](https://runapi.ai/models/grok-imagine/video-1.5-preview.md)\n- [Text to video](https://runapi.ai/models/grok-imagine/text-to-video.md)\n- [Image to video](https://runapi.ai/models/grok-imagine/image-to-video.md)\n- [Text to image](https://runapi.ai/models/grok-imagine/text-to-image.md)\n- [Edit image](https://runapi.ai/models/grok-imagine/edit-image.md)\n\nFile v0.2.10:_meta.json\n\n{\n  \"ownerId\": \"kn70me4rk7jqjt92evshjeb5z18768g7\",\n  \"slug\": \"runapi-grok-imagine\",\n  \"version\": \"0.2.10\",\n  \"publishedAt\": 1786370670515\n}\n\nFile v0.2.10:skill-card.md\n\n## Description:\n\nGenerate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[runapi-ai](https://clawhub.ai/user/runapi-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to guide agents that generate, edit, animate, or transform images and videos with Grok Imagine through RunAPI. It supports one-off CLI media generation and SDK-oriented application integration guidance.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends prompts or media to external RunAPI and Grok Imagine services.\n\nMitigation: Confirm the user is comfortable with external processing and avoid sensitive prompts or media unless appropriate.\n\nRisk: The skill depends on the RunAPI CLI or SDK authentication, including optional RUNAPI_API_KEY use.\n\nMitigation: Use environment auth or saved CLI configuration deliberately, check authentication status before use, and avoid interactive browser login unless the user requests it.\n\nRisk: RunAPI-generated file URLs are temporary.\n\nMitigation: Download generated media and store it in durable storage within 7 days when the output must be retained.\n\nRisk: Using CLI commands as a production integration layer can create fragile application behavior.\n\nMitigation: Use the documented SDK integration path for app, backend, worker, or production workflow integration.\n\n## Reference(s):\n\n- [Grok Imagine model overview](https://runapi.ai/models/grok-imagine.md)\n- [RunAPI Grok Imagine homepage](https://runapi.ai/models/grok-imagine)\n- [xAI provider page](https://runapi.ai/providers/xai.md)\n- [RunAPI model catalog](https://runapi.ai/models.md)\n- [RunAPI CLI skill guidance](https://github.com/runapi-ai/cli-skill)\n- [ClawHub skill page](https://clawhub.ai/runapi-ai/skills/runapi-grok-imagine)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Code, Configuration]\n\n**Output Format:** [Markdown with inline shell commands, SDK package names, and configuration guidance]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Guides use of external RunAPI services; generated media URLs should be downloaded to durable storage within 7 days.]\n\n## Skill Version(s):\n\n0.2.10 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v0.2.9: 3 files, 3426 bytes\n\nFiles: skill-card.md (3105b), SKILL.md (4182b), _meta.json (138b)\n\nFile v0.2.9:SKILL.md\n\n---\nname: grok-imagine\ndescription: Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.\ndocumentation: https://runapi.ai/models/grok-imagine.md\nprovider_page: https://runapi.ai/providers/xai.md\ncatalog: https://runapi.ai/models.md\nmetadata:\n  openclaw:\n    homepage: https://runapi.ai/models/grok-imagine\n    requires:\n      bins:\n      - runapi\n    install:\n    - kind: brew\n      formula: runapi-ai/tap/runapi\n      bins:\n      - runapi\n    envVars:\n    - name: RUNAPI_API_KEY\n      required: false\n      description: Optional RunAPI API key; agents should prefer environment auth or saved CLI config. Browser login is interactive fallback only.\n---\n\n# Grok Imagine on RunAPI\n\nGenerate and edit images and videos with Grok Imagine through RunAPI. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.\n\n## Critical: Integration Runtime\n\n- Integration work (app, backend, worker, library, Rails service, Node service, Go service, webhook pipeline, or production codebase) uses the **SDK integration path** for the target language.\n- One-off generation, editing, transformation, manual smoke tests, debugging, or user-requested CLI runs use the **CLI path** with the `runapi` binary. For full CLI-specific agent guidance, see https://github.com/runapi-ai/cli-skill.\n- Never shell out to the `runapi` CLI as the production runtime integration layer.\n\n## SDK integration path\n\nWhen integrating Grok Imagine into an app, backend, worker, library, Rails service, Node service, Go service, webhook pipeline, or production workflow, start by checking the current SDK package and official usage. Confirm install commands, client methods (`create`, `get`, `run`), request fields, response shape, and error classes before using CLI help or raw HTTP examples. Use a RunAPI SDK package:\n\n- JavaScript / TypeScript: `@runapi.ai/grok-imagine`\n- Python: `runapi-grok-imagine`\n- Ruby: `runapi-grok-imagine`\n- Go: `github.com/runapi-ai/grok-imagine-sdk/go`\n- Java: `ai.runapi:runapi-grok-imagine`\n- PHP: `runapi-ai/grok-imagine`\n\n## CLI path\n\nThe `runapi` binary is the one-off and manual testing runtime dependency. For full CLI-specific agent guidance, see https://github.com/runapi-ai/cli-skill. Run `runapi auth status` first. For agents and headless runs, prefer `RUNAPI_API_KEY` or import it into saved config with `printf '%s' \"$RUNAPI_API_KEY\" | runapi auth import-token --token -`. Use `runapi login` only when the user explicitly wants interactive browser auth.\n\nInspect the available commands and request fields with CLI help:\n\n```shell\nrunapi grok-imagine --help\nrunapi grok-imagine text-to-video --help\n```\n\nRun a one-off task (synchronous — polls until the task completes):\n\n```shell\nrunapi grok-imagine text-to-video --input-file request.json\n```\n\nSubmit asynchronously and poll separately:\n\n```shell\nrunapi grok-imagine text-to-video --async --input-file request.json\nrunapi wait <task-id> --service grok-imagine --action text-to-video\n```\n\nAvailable commands: `text-to-video`, `image-to-video`, `text-to-image`, `edit-image`, `extend`, `upscale-image`.\n\n## Generated file storage\n\nRunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.\n\n## References\n\n- Model overview, pricing, and rate limits: https://runapi.ai/models/grok-imagine.md\n- Full model catalog: https://runapi.ai/models.md\n\n## Variants\n\n- [Video 1.5 Fast](https://runapi.ai/models/grok-imagine/video-1.5-fast.md)\n- [Video 1.5 Preview](https://runapi.ai/models/grok-imagine/video-1.5-preview.md)\n- [Text to video](https://runapi.ai/models/grok-imagine/text-to-video.md)\n- [Image to video](https://runapi.ai/models/grok-imagine/image-to-video.md)\n- [Text to image](https://runapi.ai/models/grok-imagine/text-to-image.md)\n- [Edit image](https://runapi.ai/models/grok-imagine/edit-image.md)\n\nFile v0.2.9:_meta.json\n\n{\n  \"ownerId\": \"kn70me4rk7jqjt92evshjeb5z18768g7\",\n  \"slug\": \"runapi-grok-imagine\",\n  \"version\": \"0.2.9\",\n  \"publishedAt\": 1784283842258\n}\n\nFile v0.2.9:skill-card.md\n\n## Description: <br>\nGenerate and edit images and videos with Grok Imagine through RunAPI, using the CLI for one-off tasks and SDKs for application integrations. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[runapi-ai](https://clawhub.ai/user/runapi-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and agents use this skill to create, edit, animate, upscale, or transform media through RunAPI's Grok Imagine model. It guides one-off CLI usage and SDK-based application integration. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: RunAPI and Grok Imagine are external paid or metered services. <br>\nMitigation: Confirm the user is comfortable using the external service and any associated account, billing, pricing, and rate-limit terms before running generation tasks. <br>\nRisk: Authentication may use a local RunAPI API key or saved CLI login. <br>\nMitigation: Prefer environment-based authentication or saved CLI config, avoid exposing tokens in commands or logs, and use browser login only when the user explicitly wants interactive authentication. <br>\nRisk: RunAPI-generated file URLs are temporary. <br>\nMitigation: Download and store generated images or videos in durable storage within 7 days when the user needs long-term access. <br>\nRisk: Using the CLI as a production integration layer can create brittle application behavior. <br>\nMitigation: Use the target-language SDK path for app, backend, worker, webhook, or production integrations. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill listing](https://clawhub.ai/runapi-ai/skills/runapi-grok-imagine) <br>\n- [RunAPI Grok Imagine homepage](https://runapi.ai/models/grok-imagine) <br>\n- [RunAPI Grok Imagine model documentation](https://runapi.ai/models/grok-imagine.md) <br>\n- [RunAPI xAI provider documentation](https://runapi.ai/providers/xai.md) <br>\n- [RunAPI model catalog](https://runapi.ai/models.md) <br>\n- [RunAPI CLI skill](https://github.com/runapi-ai/cli-skill) <br>\n- [Grok Imagine video 1.5 fast](https://runapi.ai/models/grok-imagine/video-1.5-fast.md) <br>\n- [Grok Imagine text to image](https://runapi.ai/models/grok-imagine/text-to-image.md) <br>\n- [Grok Imagine edit image](https://runapi.ai/models/grok-imagine/edit-image.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Guidance, Shell commands, Code, Configuration] <br>\n**Output Format:** [Markdown guidance with inline shell commands and SDK package references] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May produce RunAPI task IDs, API responses, and temporary generated media URLs when the agent executes the described CLI or SDK workflows.] <br>\n\n## Skill Version(s): <br>\n0.2.9 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.2.8: 3 files, 3304 bytes\n\nFiles: skill-card.md (2624b), SKILL.md (4106b), _meta.json (138b)\n\nFile v0.2.8:SKILL.md\n\n---\nname: grok-imagine\ndescription: Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.\ndocumentation: https://runapi.ai/models/grok-imagine.md\nprovider_page: https://runapi.ai/providers/xai.md\ncatalog: https://runapi.ai/models.md\nmetadata:\n  openclaw:\n    homepage: https://runapi.ai/models/grok-imagine\n    requires:\n      bins:\n      - runapi\n    install:\n    - kind: brew\n      formula: runapi-ai/tap/runapi\n      bins:\n      - runapi\n    envVars:\n    - name: RUNAPI_API_KEY\n      required: false\n      description: Optional RunAPI API key; agents should prefer environment auth or saved CLI config. Browser login is interactive fallback only.\n---\n\n# Grok Imagine on RunAPI\n\nGenerate and edit images and videos with Grok Imagine through RunAPI. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.\n\n## Critical: Integration Runtime\n\n- Integration work (app, backend, worker, library, Rails service, Node service, Go service, webhook pipeline, or production codebase) uses the **SDK integration path** for the target language.\n- One-off generation, editing, transformation, manual smoke tests, debugging, or user-requested CLI runs use the **CLI path** with the `runapi` binary. For full CLI-specific agent guidance, see https://github.com/runapi-ai/cli-skill.\n- Never shell out to the `runapi` CLI as the production runtime integration layer.\n\n## SDK integration path\n\nWhen integrating Grok Imagine into an app, backend, worker, library, Rails service, Node service, Go service, webhook pipeline, or production workflow, start by checking the current SDK package and official usage. Confirm install commands, client methods (`create`, `get`, `run`), request fields, response shape, and error classes before using CLI help or raw HTTP examples. Use a RunAPI SDK package:\n\n- JavaScript / TypeScript: `@runapi.ai/grok-imagine`\n- Python: `runapi-grok-imagine`\n- Ruby: `runapi-grok-imagine`\n- Go: `github.com/runapi-ai/grok-imagine-sdk/go`\n- Java: `ai.runapi:runapi-grok-imagine`\n- PHP: `runapi-ai/grok-imagine`\n\n## CLI path\n\nThe `runapi` binary is the one-off and manual testing runtime dependency. For full CLI-specific agent guidance, see https://github.com/runapi-ai/cli-skill. Run `runapi auth status` first. For agents and headless runs, prefer `RUNAPI_API_KEY` or import it into saved config with `printf '%s' \"$RUNAPI_API_KEY\" | runapi auth import-token --token -`. Use `runapi login` only when the user explicitly wants interactive browser auth.\n\nInspect the available commands and request fields with CLI help:\n\n```shell\nrunapi grok-imagine --help\nrunapi grok-imagine text-to-video --help\n```\n\nRun a one-off task (synchronous — polls until the task completes):\n\n```shell\nrunapi grok-imagine text-to-video --input-file request.json\n```\n\nSubmit asynchronously and poll separately:\n\n```shell\nrunapi grok-imagine text-to-video --async --input-file request.json\nrunapi wait <task-id> --service grok-imagine --action text-to-video\n```\n\nAvailable commands: `text-to-video`, `image-to-video`, `text-to-image`, `edit-image`, `extend`, `upscale-image`.\n\n## Generated file storage\n\nRunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.\n\n## References\n\n- Model overview, pricing, and rate limits: https://runapi.ai/models/grok-imagine.md\n- Full model catalog: https://runapi.ai/models.md\n\n## Variants\n\n- [Video 1.5 Preview](https://runapi.ai/models/grok-imagine/video-1.5-preview.md)\n- [Text to video](https://runapi.ai/models/grok-imagine/text-to-video.md)\n- [Image to video](https://runapi.ai/models/grok-imagine/image-to-video.md)\n- [Text to image](https://runapi.ai/models/grok-imagine/text-to-image.md)\n- [Edit image](https://runapi.ai/models/grok-imagine/edit-image.md)\n\nFile v0.2.8:_meta.json\n\n{\n  \"ownerId\": \"kn70me4rk7jqjt92evshjeb5z18768g7\",\n  \"slug\": \"runapi-grok-imagine\",\n  \"version\": \"0.2.8\",\n  \"publishedAt\": 1784174500095\n}\n\nFile v0.2.8:skill-card.md\n\n## Description: <br>\nGenerate and edit images and videos with Grok Imagine through RunAPI. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[runapi-ai](https://clawhub.ai/user/runapi-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and agents use this skill to create, edit, animate, upscale, and transform images or videos with Grok Imagine through RunAPI. It guides one-off CLI use and SDK-based application integration. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The scanner reported no malicious or suspicious signals, but local artifact inspection was unavailable in that scan. <br>\nMitigation: Confirm the skill name, publisher handle, requested permissions, and install path match the intended RunAPI release before installation. <br>\nRisk: Generated media URLs are temporary and should not be treated as durable storage. <br>\nMitigation: Download and store generated images or videos in user-controlled durable storage within 7 days. <br>\nRisk: Interactive browser login can block unattended or headless agent runs. <br>\nMitigation: Prefer RUNAPI_API_KEY or saved CLI configuration for agent execution, and use browser login only when explicitly requested. <br>\nRisk: Using the CLI as a production runtime integration layer can create brittle service behavior. <br>\nMitigation: Use the SDK integration path for production application, backend, worker, or webhook workflows. <br>\n\n\n## Reference(s): <br>\n- [RunAPI Grok Imagine model page](https://runapi.ai/models/grok-imagine) <br>\n- [RunAPI Grok Imagine documentation](https://runapi.ai/models/grok-imagine.md) <br>\n- [RunAPI model catalog](https://runapi.ai/models.md) <br>\n- [RunAPI xAI provider page](https://runapi.ai/providers/xai.md) <br>\n- [ClawHub skill page](https://clawhub.ai/runapi-ai/skills/runapi-grok-imagine) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Guidance, Shell commands, Code, Configuration] <br>\n**Output Format:** [Markdown with inline shell commands and SDK package names] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Guidance may direct agents to download generated media from temporary RunAPI URLs within 7 days.] <br>\n\n## Skill Version(s): <br>\n0.2.8 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.2.4: 3 files, 2572 bytes\n\nFiles: skill-card.md (2178b), SKILL.md (2878b), _meta.json (138b)\n\nFile v0.2.4:SKILL.md\n\n---\nname: grok-imagine\ndescription: Generate and edit images with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, or transform images with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.\ndocumentation: https://runapi.ai/models/grok-imagine.md\nprovider_page: https://runapi.ai/providers/xai.md\ncatalog: https://runapi.ai/models.md\nmetadata:\n  openclaw:\n    homepage: https://runapi.ai/models/grok-imagine\n    requires:\n      bins:\n      - runapi\n    install:\n    - kind: brew\n      formula: runapi-ai/tap/runapi\n      bins:\n      - runapi\n    envVars:\n    - name: RUNAPI_API_KEY\n      required: false\n      description: Optional RunAPI API key; runapi login or saved CLI config can also authenticate the runapi binary.\n---\n\n# Grok Imagine on RunAPI\n\nGenerate and edit images with Grok Imagine through RunAPI. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.\n\n## Routing decision\n\n- One-off generation, editing, or transformation for the user → use the **CLI path** with the `runapi` binary.\n- Building an app, backend, worker, library, or production codebase → use the **SDK integration path**.\n\n## CLI path\n\nThe `runapi` binary is the runtime dependency. Authenticate with `runapi login` (browser) or set `RUNAPI_API_KEY`; a saved CLI config also works — no required environment variable.\n\nInspect the available actions and request fields with CLI help:\n\n```shell\nrunapi grok-imagine --help\nrunapi grok-imagine text-to-video --help\n```\n\nRun a one-off task (synchronous — polls until the task completes):\n\n```shell\nrunapi grok-imagine text-to-video --input-file request.json\n```\n\nSubmit asynchronously and poll separately:\n\n```shell\nrunapi grok-imagine text-to-video --async --input-file request.json\nrunapi wait <task-id> --service grok-imagine --action text-to-video\n```\n\nAvailable actions: `text-to-video`, `image-to-video`, `text-to-image`, `image-to-image`, `extend`, `upscale-image`.\n\n## SDK integration path\n\nWhen integrating Grok Imagine into an app, backend, worker, or library — not for one-off tasks — use a RunAPI SDK package:\n\n- JavaScript / TypeScript: `@runapi.ai/grok-imagine`\n- Ruby: `runapi-grok_imagine`\n- Go: `github.com/runapi-ai/grok-imagine-sdk/go`\n\n## References\n\n- Model overview, pricing, and rate limits: https://runapi.ai/models/grok-imagine.md\n- Provider comparison: https://runapi.ai/providers/xai.md\n- Full model catalog: https://runapi.ai/models.md\n\n## Variants\n\n- [Text to video](https://runapi.ai/models/grok-imagine/text-to-video.md)\n- [Image to video](https://runapi.ai/models/grok-imagine/image-to-video.md)\n- [Text to image](https://runapi.ai/models/grok-imagine/text-to-image.md)\n- [Image to image](https://runapi.ai/models/grok-imagine/image-to-image.md)\n\nFile v0.2.4:_meta.json\n\n{\n  \"ownerId\": \"kn70me4rk7jqjt92evshjeb5z18768g7\",\n  \"slug\": \"runapi-grok-imagine\",\n  \"version\": \"0.2.4\",\n  \"publishedAt\": 1779441290505\n}\n\nFile v0.2.4:skill-card.md\n\n## Description: <br>\nGenerate and edit images with Grok Imagine through RunAPI. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[runapi-ai](https://clawhub.ai/user/runapi-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this skill to guide an agent through one-off Grok Imagine image and video generation tasks with the RunAPI CLI, or to identify SDK options for app and backend integrations. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can authorize RunAPI image and video generation actions that may consume provider quota or incur cost. <br>\nMitigation: Confirm intended generation commands, RunAPI authentication method, pricing, and rate limits before execution. <br>\nRisk: The skill describes both image and video workflows while its name and summary are image-focused. <br>\nMitigation: Treat the skill as capable of image and video generation, and verify the selected action before running the CLI. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/runapi-ai/runapi-grok-imagine) <br>\n- [RunAPI Grok Imagine model overview](https://runapi.ai/models/grok-imagine) <br>\n- [RunAPI Grok Imagine documentation](https://runapi.ai/models/grok-imagine.md) <br>\n- [RunAPI xAI provider comparison](https://runapi.ai/providers/xai.md) <br>\n- [RunAPI model catalog](https://runapi.ai/models.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Guidance, Shell commands, Configuration, Code] <br>\n**Output Format:** [Markdown with inline shell commands and SDK package names] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [The skill can guide synchronous or asynchronous RunAPI CLI workflows and SDK integration choices.] <br>\n\n## Skill Version(s): <br>\n0.2.4 (source: release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>","readmeExcerpt":"Skill: grok-imagine Owner: runapi-ai Summary: Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend. Tags: latest:0.2.12 Version history: v0.2.12 | 2026-08-21T06:59:57.714Z | user Added","codeSnippets":[],"executableExamples":[{"language":"shell","snippet":"curl --fail --location https://runapi.ai/docs/api/grok-imagine/<operation>.md --output contract.md"},{"language":"shell","snippet":"runapi auth status > auth.json\njq -e '.authenticated == true' auth.json\nrunapi grok-imagine --help\nrunapi grok-imagine <operation> --help\ncurl --fail --location https://runapi.ai/docs/api/grok-imagine/<operation>.md --output contract.md"},{"language":"shell","snippet":"jq empty request.json"},{"language":"shell","snippet":"runapi grok-imagine <operation> --async --input-file request.json > task.json\ntask_id=\"$(jq -er '.id' task.json)\""},{"language":"shell","snippet":"runapi wait \"$task_id\" --service grok-imagine --action <operation> > result.json"},{"language":"shell","snippet":"curl --fail --location <deliverable-url> --output <downloaded-file>"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: grok-imagine\ndescription: \"Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.\"\ndocumentation: https://runapi.ai/models/grok-imagine.md\nprovider_page: https://runapi.ai/providers/xai.md\ncatalog: https://runapi.ai/models.md\nmetadata:\n  openclaw:\n    homepage: https://runapi.ai/models/grok-imagine\n    requires:\n      bins:\n      - runapi\n    install:\n    - kind: brew\n      formula: runapi-ai/tap/runapi\n      bins:\n      - runapi\n    envVars:\n    - name: RUNAPI_API_KEY\n      required: false\n      description: Optional RunAPI API key; agents should prefer environment auth or saved CLI config. Browser login is interactive fallback only.\n---\n\n# Grok Imagine on RunAPI\n\n## Choose route\n\n- For a one-off artifact or result, use the registered `grok-imagine` service in the `runapi` CLI. If the installed command catalog does not list it, stop and report the missing service instead of inventing a command.\n- For an app, backend, worker, library, webhook pipeline, or production codebase, go directly to **Integrate with SDK**. Never shell out to the CLI as the production runtime.\n\n## Discover contract\n\nAuthenticate, then inspect the installed command catalog and the selected operation's current contract:\n\n```shell\nrunapi auth status > auth.json\njq -e '.authenticated == true' auth.json\nrunapi grok-imagine --help\nrunapi grok-imagine <operation> --help\ncurl --fail --location https://runapi.ai/docs/api/grok-imagine/<operation>.md --output contract.md\n```\n\nIf authentication is false, stop before submitting. Ask the user to provide a valid `RUNAPI_API_KEY`, or import a user-provided key from stdin with `runapi auth import-token --token -`; use interactive browser login only when the user explicitly requests it. Choose `<operation>` only from service help. Treat command help as authoritative for the installed operation, model, and top-level field roster. Treat its API Reference as authoritative for the complete request schema, nested fields, conditional rules, task behavior, and response variants. If the two surfaces disagree, stop and report the contract mismatch instead of guessing.\n\n## Build request\n\nCreate `request.json` as valid JSON using only fields accepted by the discovered operation contract. For the chosen model and values, evaluate every applicable conditional rule as a set: satisfy every required field, omit every forbidden field, and stop on unresolved contradictions.\n\nTraverse nested objects and arrays before execution. Close every relationship stated by the discovered contract, including uniqueness constraints and cross-references between nested values.\n\nFor a discovered local media input, including file-typed fields and top-level media URL fields, put an agent-readable local file path directly in `request.jso"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn70me4rk7jqjt92evshjeb5z18768g7\",\n  \"slug\": \"runapi-grok-imagine\",\n  \"version\": \"0.2.12\",\n  \"publishedAt\": 1787295597714\n}"},{"path":"skill-card.md","content":"## Description:\n\nGenerate and edit images and videos with Grok Imagine through RunAPI.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[runapi-ai](https://clawhub.ai/user/runapi-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and external users use this skill to guide agents through one-off Grok Imagine image and video generation, media editing, and SDK integration through RunAPI.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The RunAPI CLI may make authenticated and billable service requests.\n\nMitigation: Use the skill only when RunAPI/Grok Imagine usage is intended, authenticate with approved credentials, and preserve task responses before waiting or retrying.\n\nRisk: Generated media files are downloaded from remote service responses and may be unsafe to open blindly.\n\nMitigation: Treat downloaded outputs as untrusted media files and verify that each file is non-empty and has the expected MIME type before reporting completion.\n\nRisk: Supplying unsupported request fields or guessing missing contract details can lead to failed or unintended service requests.\n\nMitigation: Inspect the installed command help and current API reference, build requests only from accepted fields, and stop when the contract is missing or contradictory.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/runapi-ai/skills/runapi-grok-imagine)\n- [RunAPI Grok Imagine homepage](https://runapi.ai/models/grok-imagine)\n- [Grok Imagine model documentation](https://runapi.ai/models/grok-imagine.md)\n- [xAI provider documentation](https://runapi.ai/providers/xai.md)\n- [RunAPI model catalog](https://runapi.ai/models.md)\n- [Grok Imagine SDK integration](https://github.com/runapi-ai/grok-imagine-sdk)\n- [Edit image variant](https://runapi.ai/models/grok-imagine/edit-image.md)\n- [Image 2.0 variant](https://runapi.ai/models/grok-imagine/image-2-0.md)\n- [Image-to-video variant](https://runapi.ai/models/grok-imagine/image-to-video.md)\n- [Text-to-image variant](https://runapi.ai/models/grok-imagine/text-to-image.md)\n- [Text-to-video variant](https://runapi.ai/models/grok-imagine/text-to-video.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown with inline shell commands, JSON request examples, and integration guidance]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Guides agents to create request JSON, execute RunAPI CLI or SDK workflows, and verify downloaded image or video files.]\n\n## Skill Version(s):\n\n0.2.12 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend. Skill: grok-imagine Owner: runapi-ai Summary: Generate and edit images and videos with Grok Imagine through RunAPI. Use when the user asks an agent to create, edit, animate, or transform media with Grok Imagine. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend. Tags: latest:0.2.12 Version history: v0.2.12 | 2026-08-21T06:59:57.714Z | user Added","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1254,"uniquenessScore":46,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T17:02:50.178Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T17:02:50.178Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T21:42:58.614Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}