Edit images with xAI Grok models via pay-per-call MPP endpoint on Tempo L2.
What it does
This MPP endpoint provides access to xAI's Grok image editing capability. You send a source image (via URL or base64 data URI) along with a text prompt describing the desired edits, and the endpoint returns the modified image. It supports two model variants: 'grok-imagine-image' (default) and 'grok-imagine-image-pro'. You can request multiple edited images per call and choose between a hosted URL or base64-encoded JSON as the response format.
The endpoint is part of a broader Grok service suite hosted by Locus MPP that also includes chat completions, image generation, web/X search, code execution, and text-to-speech. Payment is handled via the MPP protocol using the Tempo method (pathUSD on Tempo L2), with per-image pricing documented at approximately $0.02–$0.08 per edited image. The exact charge amount is dynamic and model-dependent.
Note that the probe did not receive a 402 challenge when hitting this specific path with HEAD/GET — it returned 404 instead. Since this is a POST-only endpoint, the 404 on HEAD/GET is expected behavior and does not indicate the endpoint is down. The OpenAPI spec from the service root clearly documents this path with a full request schema and payment info, confirming it is an active route.
Capabilities
Use cases
- —Applying text-described modifications to existing images (e.g., adding objects, changing backgrounds)
- —Batch-editing product photos with natural language instructions
- —Integrating AI-powered image editing into creative workflows via agent payments
- —Prototyping visual changes by describing edits in plain English
Fit
Best for
- —Agents needing pay-per-call image editing without API key management
- —Text-guided image modifications using xAI's Grok models
- —Workflows requiring both standard and pro-tier image editing quality
Not for
- —High-volume batch processing where per-image costs ($0.02–$0.08) add up significantly
- —Use cases requiring pixel-precise manual editing or layer-based compositing
- —Free or subscription-based image editing needs
Quick start
curl -X POST https://grok.mpp.paywithlocus.com/grok/image-edit \
-H "Content-Type: application/json" \
-d '{
"prompt": "Add a red hat to the person",
"image": {"url": "https://example.com/photo.jpg"},
"model": "grok-imagine-image",
"n": 1,
"response_format": "url"
}'Example
Request
{
"n": 1,
"image": "{\"url\": \"https://example.com/photo.jpg\"}",
"model": "grok-imagine-image",
"prompt": "Add a red hat to the person",
"response_format": "url"
}Endpoint
Quality
The OpenAPI spec provides a clear request schema, model options, and pricing guidance for this endpoint. However, no actual 402 challenge was captured for this specific path (POST-only route probed with HEAD/GET), no response schema or example response is documented, and the crawled pages all returned generic 404s with no additional documentation. Pricing is approximate and dynamic.
Warnings
- —Probe returned 404 on HEAD/GET — expected for a POST-only endpoint, but no direct 402 challenge was captured to confirm live payment flow
- —No response schema documented in the OpenAPI spec; response structure must be inferred
- —Pricing is listed as approximate ($0.02–$0.08 per image) with no fixed amount; actual charge is dynamic
- —The 'image' field schema says type 'string' but the description indicates it should be an object with a 'url' key — potential schema inconsistency
Citations
- —Image editing endpoint supports models 'grok-imagine-image' and 'grok-imagine-image-pro' with pricing ~$0.02–$0.08 per imagehttps://grok.mpp.paywithlocus.com
- —Payment uses Tempo method with pathUSD currencyhttps://grok.mpp.paywithlocus.com
- —Required fields are 'prompt' and 'image'; optional fields include 'model', 'n', and 'response_format'https://grok.mpp.paywithlocus.com
- —Documentation references available at https://docs.x.ai and https://beta.paywithlocus.com/mpp/grok.mdhttps://grok.mpp.paywithlocus.com