Edit and compose images with FLUX.2 Image to Image using up to eight references, auto ratio, 1K/2K output, a matched watercolor example, and API quickstart code.
Provider: Black Forest Labs
Category: image generation
Endpoint: /v1/tasks
Status: Available
Cost: See live page pricing
Edit and compose images with FLUX.2 Image to Image using up to eight references, auto ratio, 1K/2K output, a matched watercolor example, and API quickstart code.
Pricing
Standard Usage
Ready for generation
Configure your parameters and click "Run" to see the output here.
Each case separates references, the edit instruction, and the complete result, with image zoom and prompt copy.
1 reference image(s) / API result
The original scene structure remains recognizable while color, texture, and edge treatment move to a soft paper-based watercolor style.
Turn this scene into a delicate watercolor illustration with soft pastel tones and visible paper texture, keep the original composition
Choose an adjacent model by task, output tier, and reference-image needs.
Campaign-grade multi-reference editing
Choose it for demanding preservation work and up to ten reference images.
Edit and compose images with FLUX.2 Image to Image using up to eight references, auto ratio, 1K/2K output, a matched watercolor example, and API quickstart code.
The Playground and API use the same model ID: flux-2/image-to-image. Reference images provide subject, product, scene, or style facts, while the prompt assigns each role and limits the edit.
These specifications reflect the current FLUX.2 Image to Image request contract.
Final cost depends on the output tier and input add-ons. Check the live page price and task record for the final charge.
References provide visual facts; the prompt assigns their roles and limits the edit.
Copy a minimal request below. See Docs for parameters, callbacks, task retrieval, and errors.
POST /v1/tasksflux-2/image-to-imagecurl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2/image-to-image",
"input": {
"prompt": "Change the product color and preserve its structure",
"image_urls": [
"https://example.com/reference.jpg"
],
"aspect_ratio": "auto",
"resolution": "1K"
}
}'The create request immediately returns a taskId; image generation continues asynchronously.
It accepts 1 to 8 JPEG, PNG, or WebP references under 10MB each. Assign each image a clear role in multi-image prompts.
auto follows the first reference image. Choose an explicit ratio for a fixed landscape, portrait, or square output.
1K and 2K use separate per-image tiers, while reference count adds no separate fee. See the live page price for current amounts.
Assign each reference a role and state the subject, text, material, position, and lighting that must remain unchanged.
Submit model plus input.prompt, input.image_urls, input.aspect_ratio, and input.resolution.
Choose 1 to 8 publicly accessible images without redundant or conflicting roles.
Describe the requested edit and the subject, text, composition, lighting, and positions that must remain.
Check the reference relationship in Playground, then create asynchronous tasks with the same model ID.