{"uid":"cap_FV8LsqOXohjIvUrAmrEZT","slug":"agents-vimmerse-net-vimmerse-image-credit-estimator-8a6dec09","name":"Vimmerse Image Credit Estimator","description":"Returns how many credits an image generation request would charge for the given `app_name`, `option`, `quantity`, and optional `prompt`, **without** creating an asset.\n\nUses the same billing rules as **POST /v2/image/** generation routes. Send **Content-Type: application/json**.\n\n### Example\n\n```python\nimport requests\n\nurl = \"https://api.vimmerse.net/v2/image/estimate-credits\"\nheaders = {\"Content-Type\": \"application/json\"}\npayload = {\n    \"app_name\": \"text-to-image\",\n    \"option\": \"NanoBanana\",\n    \"quantity\": 2,\n    \"prompt\": \"Product photo of running shoes on a gradient background\",\n}\n\nresponse = requests.post(url, headers=headers, json=payload, timeout=30)\nresponse.raise_for_status()\nprint(response.json())\n```","url":"https://agents.vimmerse.net/v2/image/estimate-credits?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"EstimateImageCreditsRequest","required":["option"],"properties":{"option":{"type":"string","title":"Generation Option","description":"Model/tool `option` on the target image endpoint (e.g. NanoBanana, AutoI)."},"prompt":{"type":"string","title":"Prompt","default":"","description":"Used for length-based pricing when applicable."},"app_name":{"type":"string","title":"App Name","default":"text-to-image","description":"Internal route id stored on the asset record (same as the target POST /image/* route). Available values: `text-to-image` (default), `image-to-image`, `reimagine`, `face-swap`, `replace-bg`, `edit-image`, `image-elements`, `try-on`, `scene-image`, `upload-image` (0 credits)."},"quantity":{"type":"integer","title":"Quantity","default":1,"maximum":4,"minimum":1}},"description":"Body for POST /image/estimate-credits (pricing fields shared across image generation routes)."},"responseSchema":{"type":"object","title":"EstimateAssetCreditsResponse","required":["total_credits","breakdown"],"properties":{"breakdown":{"type":"object","title":"Breakdown","description":"Step-by-step pricing components.","additionalProperties":true},"total_credits":{"type":"integer","title":"Total Credits","description":"Total credits that would be charged."}},"description":"Credit estimate for asset generation (anonymous; no user balance)."},"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_BelzMPCYNHGT_tDXJlLyW","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":"Returns the exact credit cost of an image generation request (by app, model option, quantity, and prompt) without actually generating anything.","exampleAgentPrompt":"Before I generate 3 images using Vimmerse's text-to-image route with the NanoBanana option, can you check exactly how many credits that would cost for a prompt like 'stylized product photo of sneakers on a white background'?","exampleUseCases":[{"title":"Pre-flight cost check for bulk images","prompt":"I want to generate 4 images using the text-to-image route with the AutoI option on Vimmerse — can you tell me exactly how many credits that will cost before I commit?"},{"title":"Comparing pricing across model options","prompt":"How many credits would it cost to generate 2 images using the NanoBanana option versus another option for a replace-bg job on Vimmerse? Check the estimate for replace-bg with NanoBanana, quantity 2."},{"title":"Budget guard before automated workflow","prompt":"My agent is about to run a batch of face-swap image requests using the AutoI option on Vimmerse — before it fires off, estimate the credit cost for a single face-swap with quantity 1 so I can approve the budget."}],"resultDescription":"A JSON object containing `total_credits` (integer showing how many credits the request would consume) and `breakdown` (an object with step-by-step pricing components explaining how the total was calculated), without creating any asset or charging any credits.","failureModes":["Invalid or unknown `option` value returns a 422 or error response","Missing required `option` field causes a validation error","`quantity` outside the range 1–4 returns a validation error","Invalid `app_name` string may return an error or default to text-to-image","Network timeout on the POST request","Malformed JSON body returns a 400 Bad Request"],"whenToPreferThis":"Use this endpoint whenever you need to preview the credit cost of an image generation request before committing — especially useful for budget validation in automated pipelines, comparing costs across model options or app_name routes, or letting users approve spending before execution. Prefer this over the actual generation endpoints when the goal is purely cost estimation with no side effects.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T22:53:34.534Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-vimmerse-image-credit-estimator-8a6dec09"}