# Stability AI Search and Recolor via Locus x402

> Stability AI Search and Recolor via Locus x402 is a paid API for AI agents from stability-ai.x402.paywithlocus.com, paid per call via x402, $0.057/call, status unknown (last checked 2026-09-14).

Recolors or changes the appearance of a specific object in an image using text prompts, powered by Stability AI.

## Facts

- Endpoint: POST https://stability-ai.x402.paywithlocus.com/stability-ai/search-and-recolor
- Price: $0.057/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stability-ai-search-and-recolor-via-locus-x402-3f484bb5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PEYHYZHwmEhf_Nny1o_fJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stability-ai-search-and-recolor-via-locus-x402-3f484bb5 -d '<json body>'
```

Example prompt: Take this product photo and recolor just the jacket — I want it to look forest green instead of black. Output as a PNG and exclude any changes to the background.

## When to prefer this

Choose this endpoint when you need to change the color or appearance of a specific object within an existing image using natural language descriptions, rather than regenerating the entire image. It is ideal for product photography color variants, fashion/design iteration, or any scenario where the composition should remain intact but an object's color needs to change. Prefer it over full image generation when you have a real source photo and want surgical edits.

## Known failure modes

- Invalid or unreadable source image returns an error
- select_prompt too vague — fails to isolate the target object correctly
- prompt and select_prompt conflict, leading to unexpected recoloring results
- Unsupported output_format value causes validation error
- Payment failure due to insufficient USDC balance blocks the request
- Rate limiting or Stability AI upstream errors cause transient failures

## How this service works

Generative AI platform for images, 3D models, and audio — text-to-image, editing, upscaling, and more.

## Output

Returns a JSON response containing the recolored image data (in the requested format: jpeg, png, or webp), a success flag, payment settlement details in USDC, and a request ID with a status URL for tracking the async result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "seed": {
   "type": "number"
  },
  "image": {
   "type": "string"
  },
  "prompt": {
   "type": "string"
  },
  "output_format": {
   "type": "string"
  },
  "select_prompt": {
   "type": "string"
  },
  "negative_prompt": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stability-ai-search-and-recolor-via-locus-x402-3f484bb5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stability-ai.x402.paywithlocus.com](https://www.zero.xyz/host/stability-ai.x402.paywithlocus.com/llms.txt)