Photon Modify | Fast Image Editing API

Luma Photon Modify

Edit and transform images with natural language using Luma Photon Modify. Simply describe the changes you want — swap backgrounds, modify elements, or transform scenes — and watch your image transform instantly. Perfect for quick edits, background replacements, and creative modifications.

Why It Looks Great

Natural language editing: Describe changes in plain English — no complex tools needed.
Background replacement: Seamlessly swap backgrounds while preserving subjects.
Scene transformation: Modify environments, lighting, and context effortlessly.
Subject preservation: Maintains the integrity of your main subject during edits.
Prompt Enhancer: Built-in tool to refine your editing instructions.
Ultra-affordable: Professional image editing at just $0.015 per image.

Parameters

Parameter	Required	Description
prompt	Yes	Text instruction describing the edit or modification you want.
image	No	Source image to modify (upload or public URL).

How to Use

Write your edit instruction — describe what you want to change.
Use Prompt Enhancer (optional) — click to refine your instruction.
Upload your image — drag and drop or paste a public URL.
Run — click the button to apply the edit.
Download — preview and save your modified image.

Pricing

Flat rate per image.

Output	Cost
Per image	$0.015

Best Use Cases

Background Replacement — Change backgrounds to any scene or setting.
Scene Transformation — Move subjects to different environments or contexts.
Creative Compositing — Place subjects in imaginative or fantastical settings.
Product Photography — Swap product backgrounds for professional presentations.
Social Media Content — Quick edits for engaging visual content.

Example Prompts

"Change the background to large performance stage"
"Replace the background with a tropical beach at sunset"
"Put the subject in a futuristic cityscape"
"Change the setting to a cozy coffee shop interior"
"Transform the background to a snowy mountain landscape"
"Place in a professional studio with white backdrop"

Pro Tips for Best Results

Be specific about the new background or setting you want.
Photon Modify excels at background replacements and scene changes.
Include lighting and atmosphere details for more cohesive results.
Works best when the subject is clearly defined in the original image.
Use for quick iterations — at $0.015, you can experiment freely.
Combine with descriptive atmosphere: "dramatic lighting", "warm tones", "soft focus".

Notes

If using a URL, ensure it is publicly accessible.
Best results come from images with clear subject-background separation.
Processing is fast and efficient for rapid workflow integration.
Ideal for batch processing due to low cost per image.

Photon Modify API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/luma/photon-modify with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Photon Modify below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/luma/photon-modify" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "enable_base64_output": false
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("luma/photon-modify", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "image": "https://example.com/your-input.jpg",
        "enable_base64_output": false
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "luma/photon-modify",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "enable_base64_output": false
}
)

print(output["outputs"][0])  # → URL of the generated output

Photon Modify API — Frequently asked questions

What is the Photon Modify API?

Photon Modify is a Luma model for image editing, exposed as a REST API on WaveSpeedAI. Luma Photon Modify is a text-to-image generation model that converts text prompts into images for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Photon Modify API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/luma/luma-photon-modify.

How much does Photon Modify cost per run?

Photon Modify starts at $0.015 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Photon Modify accept?

Key inputs: `prompt`, `image`, `enable_base64_output`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/luma/luma-photon-modify.

How long does Photon Modify take to generate?

Average end-to-end generation time on WaveSpeedAI is around 15 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Photon Modify outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Luma). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

ExemplesTout voir

Modèles associés

README