How do I install the Codia Image Replace Bg skill?

Run npx skillmds@latest add codia-ai/codia-image-replace-bg in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Codia Image Replace Bg safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Codia Image Replace Bg?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Codia Image Replace Bg free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Codia Image Replace Bg?

codia-ai (@codia-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Codia Image Replace Bg by codia-ai — Agent Skill

Name: Codia Image Replace Bg
Author: codia-ai

File contents

codia-image-replace-bg

Runtime And Auth

Use the local codia-design CLI for this feature. Before calling the API, verify that codia-design is available. If it is missing and global npm installs are allowed, install it with npm install -g @codia-ai/codia-design-cli. Then check codia-design auth status; if it is not connected, run codia-design auth login --platform codex or bind an API key with codia-design auth set --api-key api_key_xxx. Never print API keys or ~/.codia/design-skills/config.json.

Keep the main body of the image and replace the background with a text description.

CLI Command

codia-design image replace-bg \
  --image <PATH|URL> \
  --prompt "TEXT" \
  [--model MODEL] \
  [--download-dir DIR] \
  [--no-download] \
  [--out FILE]

Parameters

Flag	Type	Required	Default	Description
`--image`	path \| URL	yes	—	source image
`--prompt`	string	yes	—	Text description of the new background, the more specific the better
`--model`	string	no	`nano_banana_2`	optional `nano_banana_pro`, `ideogram_v3`
`--download-dir`	path	no	`.`	Directory for downloaded image output
`--no-download`	flag	no	false	Return JSON only; do not download image output
`--out`	path	no	stdout

Prompt suggestion: Describe the surface material ("clean white marble"), lighting ("soft studio lighting"), and scene ("outdoor sunset").

Response

{ "ok": true, "data": { "image_urls": ["https://cdn.codia.ai/replaced/result.png"] } }

By default the CLI downloads data.image_urls and appends data.local_file and data.local_files to the JSON response. Use --no-download only for JSON-only workflows.

Usage Example

codia-design image replace-bg \
  --image ./product.png \
  --prompt "clean white marble table with soft studio lighting" \
  --download-dir ./outputs \
  --out result.json

Errors & Billing

HTTP	Meaning	Fix
400	Missing image or prompt
402	Insufficient credits

Credits: 13 credits/request. After the command completes, the CLI checks available_credits and reminds the user if the remaining balance is below 26 credits (2x estimate); this does not block generation. · Duration: Synchronous, usually 5–15s

---name: codia-image-replace-bgdescription: Replace image backgrounds with Codia Design CLI. Trigger when the user asks for studio backgrounds, lifestyle scenes, ecommerce backgrounds, or product scene changes.---# codia-image-replace-bg## Runtime And AuthUse the local `codia-design` CLI for this feature. Before calling the API, verify that `codia-design` is available. If it is missing and global npm installs are allowed, install it with `npm install -g @codia-ai/codia-design-cli`. Then check `codia-design auth status`; if it is not connected, run `codia-design auth login --platform codex` or bind an API key with `codia-design auth set --api-key api_key_xxx`. Never print API keys or `~/.codia/design-skills/config.json`.Keep the main body of the image and replace the background with a text description.## CLI Command```bashcodia-design image replace-bg \ --image <PATH|URL> \ --prompt "TEXT" \ [--model MODEL] \ [--download-dir DIR] \ [--no-download] \ [--out FILE]```## Parameters| Flag | Type | Required | Default | Description ||---|---|---|---|---|| `--image` | path \| URL | yes | — | source image || `--prompt` | string | yes | — | Text description of the new background, the more specific the better || `--model` | string | no | `nano_banana_2` | optional `nano_banana_pro`, `ideogram_v3` || `--download-dir` | path | no | `.` | Directory for downloaded image output || `--no-download` | flag | no | false | Return JSON only; do not download image output || `--out` | path | no | stdout | |**Prompt suggestion**: Describe the surface material ("clean white marble"), lighting ("soft studio lighting"), and scene ("outdoor sunset").## Response```json{ "ok": true, "data": { "image_urls": ["https://cdn.codia.ai/replaced/result.png"] } }```By default the CLI downloads `data.image_urls` and appends `data.local_file` and `data.local_files` to the JSON response. Use `--no-download` only for JSON-only workflows.## Usage Example```bashcodia-design image replace-bg \ --image ./product.png \ --prompt "clean white marble table with soft studio lighting" \ --download-dir ./outputs \ --out result.json```## Errors & Billing| HTTP | Meaning | Fix ||---|---|---|| 400 | Missing image or prompt | || 402 | Insufficient credits | |**Credits**: 13 credits/request. After the command completes, the CLI checks `available_credits` and reminds the user if the remaining balance is below 26 credits (2x estimate); this does not block generation. · **Duration**: Synchronous, usually 5–15s

Frequently asked questions

Codia Image Replace Bg