{"uid":"cap_3S_vb-H4e4vgjDCTDmYQx","slug":"vimmerse-text-to-image-generation-de63c3d1","name":"Vimmerse Text-to-Image Generation","description":"Generates one to four images from a text prompt with the chosen model, and returns the asset with the output URLs in results. AutoI picks a model automatically. Credits depend on the model tier and the quantity.","url":"https://agents.vimmerse.co/v2/image/text-2-image?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"option":{"enum":["AutoI","Seedream","NanoBananaT2","NanoBananaPro","QwenImage","GPTImage","FluxPro","FluxTurbo","NanoBanana","FluxKontextPro","StableDiffusion3.5"],"type":"string","default":"AutoI","description":"Model: AutoI picks one automatically. The choice sets the credits per call; POST /v2/image/estimate-credits returns the exact number for this body."},"prompt":{"type":"string","description":"Text description of the image to generate."},"quantity":{"type":"integer","default":1,"maximum":4,"minimum":1,"description":"Number of images, 1 to 4."},"async_mode":{"type":"boolean","default":false,"description":"When true the call returns at once with status processing and the asset id, and GET /v2/asset/{asset_id} returns the result when status is success. When false (default) the call waits for the images."},"webhook_url":{"type":"string","format":"uri","description":"Optional callback URL that receives the finished asset."},"aspect_ratio":{"enum":["21:9","16:9","4:3","3:2","1:1","2:3","3:4","9:16","9:21"],"type":"string","default":"16:9","description":"Output aspect ratio."},"enhance_image":{"type":"boolean","default":false,"description":"Applies 1x super-resolution after generation."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.12","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.25","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"12.0000","medianCents":"12.0000","p90Cents":"12.0000","minCents":"12.0000","maxCents":"12.0000","p95Cents":"12.0000","sampleCount":1,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.12/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AISGG9zyMp-kIMvIDR_NO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.12","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates 1–4 images from a text prompt using a selectable AI model (or auto-selected model), returning output image URLs in the response asset.","exampleAgentPrompt":"Generate 2 images of a futuristic city skyline at sunset with neon reflections on wet streets, using the FluxPro model, in 16:9 aspect ratio, and apply super-resolution enhancement.","exampleUseCases":[{"title":"Marketing visual for social campaign","prompt":"Create 4 images of a minimalist coffee cup on a wooden table with soft morning light, using the GPTImage model in 1:1 aspect ratio — I need options to pick from for our Instagram post."},{"title":"Concept art for indie game","prompt":"Generate a 16:9 image of a dark fantasy dungeon with glowing runes on stone walls using the FluxPro model — this is for a game concept I'm pitching."},{"title":"Portrait asset with auto model selection","prompt":"I need a portrait-format image (9:16) of a professional businesswoman in a modern office, let AutoI pick the best model, and apply super-resolution so it's crisp."}],"resultDescription":"Returns an asset object containing the generation status and a results array with output image URLs. If async_mode is true, returns immediately with status 'processing' and an asset_id that can be polled via GET /v2/asset/{asset_id}; if false, waits and returns the completed images directly.","failureModes":["Invalid or empty prompt returns a 400 error","Unsupported aspect ratio or model enum value causes a validation error","Exceeding quantity maximum of 4 returns a validation error","Insufficient credits for the selected model tier causes a payment or authorization error","Webhook URL unreachable results in failed delivery with no retry guarantee","Async job may remain in 'processing' state if upstream model is overloaded"],"whenToPreferThis":"Choose this endpoint when you need to generate still images from text descriptions with fine-grained control over model selection (including premium options like FluxPro, GPTImage, or Stable Diffusion 3.5), quantity (up to 4 images per call), and aspect ratio. It is especially useful when you want auto-model selection (AutoI), optional super-resolution enhancement, or asynchronous generation with webhook callbacks. Prefer this over video generation endpoints when the output should be static images, not video clips.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":4,"lastUsedAt":"2026-11-03T00:57:42.443Z","lastSuccessfullyRanAt":"2026-11-03T00:57:42.443Z","lastHealthCheckAt":"2026-11-04T12:00:03.063Z","isFirstParty":false,"canonicalSlug":"vimmerse-text-to-image-generation-de63c3d1"}