MetaMediumHigh

Muse Image 1.0 Edit

Edit an existing image with Meta's Muse Image model - pass a source image URL and a prompt describing the change. Up to 10 variants per request, webp/png/jpeg output.

24 credits

per image

Prompt-driven edits of a source image (png/jpeg/webp)

Up to 10 edited variants per request (billed per image)

Optional aspect ratio change via WxH size presets

Same per-image price as generation - no separate input fee

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "meta/muse-image-1.0/edit",
  "input": {
    "prompt": "Make it golden hour and add a small red bicycle leaning on the wall",
    "image": "https://files.core.today/aiapi/6f8aed9a74674cd1/public/SlzMWjEAXHIdNTyTRKe6jV2keHjUXZ2k/0.jpg"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Text prompt describing the edit to apply.
`image`	string	Yes	-	Source image URL to edit (png/jpeg/webp).
`n`	integer	No	1	Number of edited variants to generate (1-10). Billed per image.
`size`	string	No	-	Output aspect ratio as WxH (ratio only, native resolution). Omit to keep the source image's ratio. 1024x10241792x10241024x17921536x10241024x15361280x720720x1280
`output_format`	string	No	webp	Output image format. webppngjpeg

How to Provide File Input

There are 3 ways to provide files for the image parameter:

Recommended

Image URL

Pass a publicly accessible URL directly. With the Storage API (POST /v1/files/upload-url) the file uploads straight to S3 (50MB per file) and you pass the returned file_url.

{
  "model": "meta/muse-image-1.0/edit",
  "input": {
    "prompt": "your prompt here",
    "image": "https://example.com/image.jpg"
  }
}

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step, but the bytes pass through the API server so the whole request is capped at 10MB.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=meta/muse-image-1.0/edit" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image=@your_file.png"

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Edit an existing image

Changes the lighting and adds an object to a source photo.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "meta/muse-image-1.0/edit",
  "input": {
    "prompt": "Make it golden hour and add a small red bicycle leaning on the wall",
    "image": "https://files.core.today/aiapi/6f8aed9a74674cd1/public/SlzMWjEAXHIdNTyTRKe6jV2keHjUXZ2k/0.jpg"
  }
}'