{"skill":{"slug":"dlazy-recraft-v4-pro","displayName":"Dlazy Recraft V4 Pro","summary":"4MP high-resolution raster image generation. Suitable for print-ready assets and large-scale use.","description":"---\nname: dlazy-recraft-v4-pro\nversion: 1.2.0\ndescription: 4MP high-resolution raster image generation. Suitable for print-ready assets and large-scale use.\nmetadata:\n  {\n    'clawdbot':\n      {\n        'emoji': '🤖',\n        'requires': { 'bins': ['npm', 'npx'] },\n        'install': 'npm install -g @dlazy/cli@latest',\n        'installAlternative': 'npx @dlazy/cli@latest',\n        'homepage': 'https://github.com/dlazyai/cli',\n        'source': 'https://github.com/dlazyai/cli',\n        'author': 'dlazyai',\n        'license': 'see-repo',\n        'npm': 'https://www.npmjs.com/package/@dlazy/cli',\n        'configLocation': '~/.dlazy/config.json',\n        'apiEndpoints': ['api.dlazy.com', 'files.dlazy.com'],\n      },\n    'openclaw': { 'systemPrompt': 'When invoking this skill, use dlazy recraft-v4-pro -h for help.' },\n  }\n---\n\n# dlazy-recraft-v4-pro\n\n[English](./SKILL.md) · [中文](./SKILL-cn.md)\n\n4MP high-resolution raster image generation. Suitable for print-ready assets and large-scale use.\n\n## Trigger Keywords\n\n- recraft-v4-pro\n\n## Authentication\n\nAll requests require a dLazy API key. The recommended way to authenticate is:\n\n```bash\ndlazy login\n```\n\nThis runs a device-code flow (also works in remote shells) and **automatically saves your API key** to the local CLI config — no manual copy/paste required.\n\n### Alternative: Set the Key Manually\n\nIf you already have an API key, you can save it directly:\n\n```bash\ndlazy auth set YOUR_API_KEY\n```\n\nThe CLI saves the key in your user config directory (`~/.dlazy/config.json` on macOS/Linux, `%USERPROFILE%\\.dlazy\\config.json` on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the `DLAZY_API_KEY` environment variable.\n\n### Getting Your API Key Manually\n\n1. Sign in or create an account at [dlazy.com](https://dlazy.com)\n2. Go to [dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key)\n3. Copy the key shown in the API Key section\n\nEach key is scoped to your dLazy organization and can be **rotated or revoked at any time** from the same dashboard.\n\n## About & Provenance\n\n- **CLI source code**: [github.com/dlazyai/cli](https://github.com/dlazyai/cli)\n- **Maintainer**: dlazyai\n- **npm package**: `@dlazy/cli` (pinned to `1.0.9` in this skill's install spec)\n- **Homepage**: [dlazy.com](https://dlazy.com)\n\nYou can install on demand without persisting a global binary by running:\n\n```bash\nnpx @dlazy/cli@latest <command>\n```\n\nOr, if you prefer a global install, the skill's `metadata.clawdbot.install` field declares the exact pinned version (`npm install -g @dlazy/cli@latest`). Review the GitHub source before installing.\n\n## How It Works\n\nThis skill is a thin client over the dLazy hosted API. When you invoke it:\n\n- Prompts and parameters you provide are sent to the dLazy API endpoint (`api.dlazy.com`) for inference.\n- Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (`files.dlazy.com`) so the model can read them — the same flow as any cloud-based generation API.\n- Generated output URLs returned by the API are hosted on `files.dlazy.com`.\n\nThis is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See [dlazy.com](https://dlazy.com) for the full service terms.\n\n## Usage\n\n**CRITICAL INSTRUCTION FOR AGENT**:\nExecute `dlazy recraft-v4-pro` to get the result.\n\n```bash\ndlazy recraft-v4-pro -h\n\nOptions:\n  --prompt [prompt]                    Prompt\n  --aspect_ratio [aspect_ratio]        Aspect Ratio [default: auto] (choices: \"auto\", \"1:1\", \"4:3\", \"3:4\", \"16:9\", \"9:16\", \"3:2\", \"2:3\", \"2:1\", \"1:2\")\n  --dry-run                            Print payload + cost estimate without calling API\n  --no-wait                            Return generateId immediately for async tasks\n  --timeout <seconds>                  Max seconds to wait for async completion (default: \"1800\")\n  -h, --help                           display help for command\n```\n\n> Any flag also accepts pipe references — `-` (auto-pick from upstream stdin), `@N` (n-th output), `@N.path` (jsonpath into output), `@*` (all primary values), `@stdin` / `@stdin:path` (whole envelope). See `dlazy --help` for details.\n\n## Output Format\n\n```json\n{\n  \"ok\": true,\n  \"result\": {\n    \"tool\": \"recraft-v4-pro\",\n    \"modelId\": \"recraft-v4-pro\",\n    \"outputs\": [\n      {\n        \"type\": \"image\",\n        \"id\": \"o_xxxxxxxx\",\n        \"url\": \"https://files.dlazy.com/result.png\",\n        \"mimeType\": \"image/png\"\n      }\n    ]\n  }\n}\n```\n\n> Async tasks (when `--no-wait` is passed) return `outputs: []` and a `task: { generateId, status }` field instead. Use `dlazy status <generateId> --wait` to poll.\n\n## Examples\n\n```bash\ndlazy recraft-v4-pro --prompt 'prompt content'\n```\n\n## Error Handling\n\n| Code | Error Type                         | Example Message                                                                                                          |\n| ---- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\n| 401  | Unauthorized (No API Key)          | `ok: false, code: \"unauthorized\", message: \"API key is missing or invalid\"`                                              |\n| 501  | Missing required parameter         | `error: required option '--prompt <prompt>' not specified`                                                               |\n| 502  | Local file read error              | `Error: Image file/Video file not found: C:\\path\\to\\your\\file`                                                           |\n| 503  | API request failed (no balance)    | `ok: false, code: \"insufficient_balance\"`                                                                                |\n| 503  | API request failed (server error)  | `HTTP status code error (500 server crash)`                                                                              |\n| 504  | Asynchronous task execution failed | `=== Generation Failed ===` / `{Specific error reason returned by backend, for example \"Prompt violates safety policy\"}` |\n\n> **AGENT CRITICAL INSTRUCTION**:\n>\n> 1. If the execution result returns `code: \"insufficient_balance\"`, you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: [https://dlazy.com/dashboard/organization/settings?tab=credits](https://dlazy.com/dashboard/organization/settings?tab=credits)\n> 2. If the execution result returns `code: \"unauthorized\"` or indicates missing API key, you MUST inform the user to get their API key from [https://dlazy.com/dashboard/organization/api-key](https://dlazy.com/dashboard/organization/api-key) and save it using `dlazy auth set <key>` and resume the task.\n\n## Tips\n\nVisit https://dlazy.com for more information.\n","tags":{"latest":"1.2.0"},"stats":{"comments":0,"downloads":831,"installsAllTime":1,"installsCurrent":1,"stars":0,"versions":4},"createdAt":1777621933931,"updatedAt":1780394293509},"latestVersion":{"version":"1.2.0","createdAt":1780394293509,"changelog":"- Updated default CLI install behavior to use the latest version of @dlazy/cli instead of version 1.0.9.\n- Changed install instructions and metadata to reference @latest tag for npm/npx commands.\n- Removed the file skill-card.md from the project.\n- Minor clarifications and formatting updates in documentation.","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"dlazyai","userId":"s170j1ymymrxasgd00dsk7tckx84cf45","displayName":"dlazy","image":"https://avatars.githubusercontent.com/u/274158181?v=4"},"moderation":null}