# Image to Prompt

> Image to Prompt is a paid API for AI agents from agents.vimmerse.net, paid per call via MPP, price unknown, status unknown (last checked 2026-10-31).

Analyzes an image URL and returns a descriptive text prompt that captures the image's content and style.

## Facts

- Endpoint: POST https://agents.vimmerse.net/v2/text/image-2-prompt?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Provider: agents.vimmerse.net
- Website: https://agents.vimmerse.net
- Canonical page: https://www.zero.xyz/c/agents-vimmerse-net-image-to-prompt-27545de7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MvIE-LsoVrfyunF3fKlM_

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 agents-vimmerse-net-image-to-prompt-27545de7 -d '<json body>'
```

Example prompt: Look at this image — https://media.vimmerse.net/example/photo.jpg — and give me a text prompt that fully describes it, so I can use it to regenerate or recreate something similar.

## When to prefer this

Choose this endpoint when you need to extract a text prompt or natural language description from an existing image URL in a single synchronous call. It is the dedicated shortcut for the Image2Prompt operation, equivalent to POST /v2/text/prompt with option Image2Prompt but simpler to call. Prefer it over general vision APIs when working within the Vimmerse ecosystem, especially if you need the output to feed back into Vimmerse image or video generation pipelines.

## Known failure modes

- Invalid or inaccessible image URL returns an error
- Image URL points to a non-image resource causing processing failure
- Network timeout if the image is very large or the URL is slow to respond (120s timeout)
- Authentication failure if X-Api-Key is missing or invalid (402 or 401 response)
- Unsupported image format may result in an error or poor description

## How this service works

Describes **`image_url`** in one prompt (same as **POST /v2/text/prompt** with `"option": "Image2Prompt"`).

```python
import requests

r = requests.post(
    "https://api.vimmerse.net/v2/text/image-2-prompt",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={"image_url": "https://media.vimmerse.net/example/photo.jpg"},
    timeout=120,
)
print(r.json())
```

## Output

A single string containing a descriptive text prompt that characterizes the content, style, composition, colors, and key elements of the provided image — suitable for use as input to image generation models.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "Image2PromptRequest",
 "required": [
  "image_url"
 ],
 "properties": {
  "image_url": {
   "type": "string",
   "title": "Image URL",
   "minLength": 1
  }
 },
 "description": "Request body for POST /v2/text/image-2-prompt."
}
```

## Response schema (JSON Schema)

```json
{
 "type": "string",
 "title": "Response Generate Prompt From Image V2 Text Image 2 Prompt Post"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-vimmerse-net-image-to-prompt-27545de7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.vimmerse.net](https://www.zero.xyz/host/agents.vimmerse.net/llms.txt)