Skip to main content
ArtEmotion
Image

SD 3 Medium (Edit)

Credit-based pricing. Supports reference images, batch up to 4.

SD 3 Medium (Edit) preview
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 realism
Try 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
FieldTypeRequirementContract
model_idconstantRequiredArtEmotion model identifier.
extraobjectOptionalModel-specific settings may also be nested here.
max_creditsnumberOptionalReject before submission if the estimated list price exceeds this cap. · Range: 1–…
webhook_urlstringOptionalFormat: uri
webhook_secretstringOptionalOptional model input.
folder_idstringOptionalOptional model input.
promptstringRequiredOptional model input.
prompt_expansionbooleanOptionalIf set to true, prompt will be upsampled with more details. · Default: false
num_inference_stepsnumberOptionalThe number of inference steps to perform. · Default: 28 · Range: 1–50
strengthnumberOptionalThe strength of the image-to-image transformation. · Default: 0.9 · Range: 0.01–1
seedintegerOptionalThe same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time.
negative_promptstringOptionalThe negative prompt to generate an image from. · Default:
guidance_scalenumberOptionalThe 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_checkerbooleanOptionalIf set to true, the safety checker will be enabled. · Default: true
aspect_ratiostringOptionalAllowed: 1:1, 16:9, 9:16, 4:3, 3:4, Custom
resolutionstringOptionalAllowed: 512, 1024, 2048
num_imagesintegerOptionalRange: 1–4
reference_image_urlsarray<string>RequiredItems: 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.