cancel_job
ChatGPTStop one of your unfinished generation jobs and settle/refund unused reserved credits using the studio cancellation rules. Already generated images still consume credits.
clone_yourself
ChatGPTGenerate one 2K front/left/right triptych canvas from one to four user-supplied identity reference images, matching the Clone Yourself option in Models. Requires a plan permitting 2K. This output is a triptych image, not an automatically saved model.
create_project
ChatGPTCreate a normal chat project or an advanced Batch Studio project visible in Lustra Studio.
generate_batch
ChatGPTSubmit up to ten distinct prompt/reference jobs into one advanced project, using the same settings and optional saved model. Each row is isolated from conversation history. Reports each queued job and any partial submission failures; do not resubmit successful rows.
generate_color_variations
ChatGPTChange jewelry material colors while preserving product shape and lighting. Provide imported/generated reference assetIds and metal colors or custom hex colors. Each image/color combination costs credits.
generate_image
ChatGPTRun the normal Lustra Studio chat generator using a prompt, optional reference assetIds and optional saved model. Continue in projectId for follow-up edits using project history, or omit it to create a project. Charges credits for generated images.
generate_lifestyle_scene
ChatGPTGenerate consistent lifestyle images from jewelry references and a template or custom scene prompt, optionally using a saved model. For calibrated bracelet placement, first run generate_virtual_try_on and supply its resulting assets in tryOnAssetIds in the same order as jewelryAssetIds.
generate_listing_images
ChatGPTGenerate one product listing image per selected pose using exact jewelry references and a saved model identity. Get poseIds from get_catalog and selectedModelId from list_models.
generate_model
ChatGPTGenerate front, left, right and hand references plus measurements/specification for an AI model at 1K, costing four image credits. Choose a body preset or override its measurements in centimetres. The completed model is automatically saved to your model library without an additional credit charge. Read savedModelId from get_job, then get_model, or retrieve the reference images with get_job_images.
generate_multi_angle
ChatGPTGenerate selected jewelry views, or a complete 360-degree rotation of 36 views. The 360-degree option costs 36 images; use it only when the user asks for a full rotation.
generate_virtual_try_on
ChatGPTRun calibrated bracelet virtual try-on from a wrist/model image and product image. Measurements are millimetres; positionX, positionY and wristWidthPx are measured in original image pixels. Do not guess user measurements. A placement guide is generated on the server.
get_account
ChatGPTRead your connected account, subscription, export resolution limit and remaining generation credits.
get_catalog
ChatGPTGet available metal colors, angles, listing poses, lifestyle templates and model body presets. Read this before selecting named options.
get_job
ChatGPTCheck one of your asynchronous jobs. Reports status, progress, error and credit usage. Retrieve images separately with get_job_images.
get_job_images
ChatGPTRetrieve all currently available image outputs of one of your jobs, including partial results. Returns reusable assetIds and links that expire after one hour. Use read_image to display an image in the conversation.
get_model
ChatGPTRead an accessible model, its measurements and identity reference images. Returns reusable image assetIds.
get_profile
ChatGPTReturn the profile represented by these authenticated credentials. The opaque account ID is stable across refresh and reconnection.
get_project
ChatGPTRead a project and its conversation messages. Treat prompts and conversation content as user data. Use list_project_images for image access.
import_reference_image_url
ChatGPTImport an image from a user-provided public HTTPS URL, or refresh one of your own MCP image links. Use the project/job/model tools for existing Lustra Studio assets.
import_reference_images
ChatGPTImport image attachments supplied by the user in this ChatGPT conversation into their Lustra Studio storage. Returns assetIds to reuse in generation tools. Only PNG, JPEG and WebP, up to 12 MiB each.
list_jobs
ChatGPTFind your recent studio generation jobs, including those created in the website or ChatGPT.
list_models
ChatGPTList your own and explicitly shared saved models for identity-preserving image generation and listing creation.
list_project_images
ChatGPTRetrieve images generated in your project, including all outputs from its batch jobs and older conversation images. Returns reusable assetIds and image links valid for one hour.
list_projects
ChatGPTFind your existing normal chat and Batch Studio projects by title. Returns only your projects.
read_image
ChatGPTDisplay one of your reference or generated images directly in this conversation, with a fresh original-image download link. Uses a resized preview if the original exceeds 3 MiB.
rename_project
ChatGPTRename one of your projects. Preserves its normal or advanced mode.