{"uid":"cap_MvIE-LsoVrfyunF3fKlM_","slug":"agents-vimmerse-net-image-to-prompt-27545de7","name":"Image to Prompt","description":"Describes **`image_url`** in one prompt (same as **POST /v2/text/prompt** with `\"option\": \"Image2Prompt\"`).\n\n```python\nimport requests\n\nr = requests.post(\n    \"https://api.vimmerse.net/v2/text/image-2-prompt\",\n    headers={\"X-Api-Key\": \"YOUR_API_KEY\", \"Content-Type\": \"application/json\"},\n    json={\"image_url\": \"https://media.vimmerse.net/example/photo.jpg\"},\n    timeout=120,\n)\nprint(r.json())\n```","url":"https://agents.vimmerse.net/v2/text/image-2-prompt?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."},"responseSchema":{"type":"string","title":"Response Generate Prompt From Image V2 Text Image 2 Prompt Post"},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_n4K-ehWpAJRJawXmeMpWh","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.vimmerse.net","brandSlug":"agents-vimmerse-net-x402","brandBaseUrl":"https://agents.vimmerse.net","brandDocsUrl":null,"whatItDoes":"Analyzes an image URL and returns a descriptive text prompt that captures the image's content and style.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Reverse-engineer a reference image","prompt":"I have this inspiration photo at https://media.vimmerse.net/example/landscape.jpg — can you analyze it and give me a text prompt that captures its style, colors, and composition so I can recreate something similar?"},{"title":"Build a prompt library from existing photos","prompt":"I have a product photo at https://cdn.mystore.com/product123.jpg — describe it as a detailed text prompt so I can save it to my prompt library for future image generation."},{"title":"Understand AI-generated image composition","prompt":"Can you look at this AI-generated artwork at https://gallery.example.com/ai-art-piece.png and tell me what text prompt was likely used to create it?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:40:25.641Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-image-to-prompt-27545de7"}