Image
SD 3 Medium (Edit)
Credit-based pricing. Supports reference images, batch up to 4.

Output
image
Aspect ratio
1:1, 16:9, 9:16, 4:3, 3:4, Custom
Resolution
512, 1024, 2048
Max batch
4
Inputs
- Reference image (required)
- Batch up to 4 per request
Example prompt
Transform this medieval castle into an enchanted fantasy stronghold — glowing magical runes carved into the stone walls, ethereal blue and violet aurora lights swirling around the towers, a mystical fire burning at the highest turret, crystalline dragon perched on a battlement, enchanted forest with luminous trees replacing the surrounding landscape, ultra-detailed, cinematic fantasy realismTry this prompt →
LLM-ready
API & LLM schema
Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/stable-diffusion-v3-medium/image-to-image.
POST
/api/v1/generate18 fields · 3 required| Field | Type | Requirement | Contract |
|---|---|---|---|
model_id | constant | Required | ArtEmotion model identifier. |
extra | object | Optional | Model-specific settings may also be nested here. |
max_credits | number | Optional | Reject before submission if the estimated list price exceeds this cap. · Range: 1–… |
webhook_url | string | Optional | Format: uri |
webhook_secret | string | Optional | Optional model input. |
folder_id | string | Optional | Optional model input. |
prompt | string | Required | Optional model input. |
prompt_expansion | boolean | Optional | If set to true, prompt will be upsampled with more details. · Default: false |
num_inference_steps | number | Optional | The number of inference steps to perform. · Default: 28 · Range: 1–50 |
strength | number | Optional | The strength of the image-to-image transformation. · Default: 0.9 · Range: 0.01–1 |
seed | integer | Optional | The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time. |
negative_prompt | string | Optional | The negative prompt to generate an image from. · Default: |
guidance_scale | number | Optional | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show · Default: 5 · Range: 0–20 |
enable_safety_checker | boolean | Optional | If set to true, the safety checker will be enabled. · Default: true |
aspect_ratio | string | Optional | Allowed: 1:1, 16:9, 9:16, 4:3, 3:4, Custom |
resolution | string | Optional | Allowed: 512, 1024, 2048 |
num_images | integer | Optional | Range: 1–4 |
reference_image_urls | array<string> | Required | Items: 0–4 |
Minimal request example
{
"model_id": "fal-ai/stable-diffusion-v3-medium/image-to-image",
"prompt": "Transform this medieval castle into an enchanted fantasy stronghold — glowing magical runes carved into the stone walls, ethereal blue and violet aurora lights swirling around the towers, a mystical fire burning at the highest turret, crystalline dragon perched on a battlement, enchanted forest with luminous trees replacing the surrounding landscape, ultra-detailed, cinematic fantasy realism",
"reference_image_urls": []
}Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fstable-diffusion-v3-medium%2Fimage-to-image",
"title": "SD 3 Medium (Edit) generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/stable-diffusion-v3-medium/image-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/stable-diffusion-v3-medium/image-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"prompt_expansion": {
"title": "Prompt Expansion",
"description": "If set to true, prompt will be upsampled with more details.",
"default": false,
"type": "boolean"
},
"num_inference_steps": {
"title": "Num Inference Steps",
"description": "The number of inference steps to perform.",
"default": 28,
"type": "number",
"minimum": 1,
"maximum": 50,
"multipleOf": 1
},
"strength": {
"title": "Strength",
"description": "The strength of the image-to-image transformation.",
"default": 0.9,
"type": "number",
"minimum": 0.01,
"maximum": 1
},
"seed": {
"title": "Seed",
"description": "The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.",
"type": "integer"
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "The negative prompt to generate an image from.",
"default": "",
"type": "string"
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show",
"default": 5,
"type": "number",
"minimum": 0,
"maximum": 20
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"Custom"
]
},
"resolution": {
"type": "string",
"enum": [
"512",
"1024",
"2048"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 4
}
},
"required": [
"model_id",
"prompt",
"reference_image_urls"
],
"additionalProperties": false
}FAQ
How much does SD 3 Medium (Edit) cost on ArtEmotion?
Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.
Do I get my credits back if SD 3 Medium (Edit) fails?
Yes — failed generations are never charged. The credits are released back to your balance automatically.
Can I call SD 3 Medium (Edit) from the API?
Yes. Use POST /api/v1/generate with model_id: "fal-ai/stable-diffusion-v3-medium/image-to-image". See the API reference for the full schema.
Where are my generations stored?
Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.
Ready to generate with SD 3 Medium (Edit)?
Start now →No commitment. New accounts get 50 free credits on signup. See pricing.