Image

HiDream O1 Edit

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

Try HiDream O1 Edit →Compare models

Output

image

Aspect ratio

1:1, 16:9, 9:16, 4:3, 3:4, Custom

Resolution

1024, 2048

Max batch

Inputs

Reference image (required)

Batch up to 4 per request

Example prompt

Replace the perfume bottle with a lipstick, keep the same lighting and background, photorealistic

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/hidream-o1-image/edit.

POST/api/v1/generate17 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.
`num_inference_steps`	number	Optional	Number of denoising steps. More = higher quality, slower. · Default: 50 · Range: 1–50
`guidance_scale`	number	Optional	Classifier-free guidance scale. Higher = more faithful to prompt. · Default: 5 · Range: 0–20
`keep_original_aspect`	boolean	Optional	When one reference image is provided, preserve its aspect ratio for the output. · Default: false
`enable_safety_checker`	boolean	Optional	Filter potentially unsafe content from the output. · Default: true
`output_format`	string	Optional	Output image format. · Allowed: jpeg, png, webp · Default: png
`seed`	integer	Optional	Random seed for reproducible generation.
`aspect_ratio`	string	Optional	Allowed: 1:1, 16:9, 9:16, 4:3, 3:4, Custom
`resolution`	string	Optional	Allowed: 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/hidream-o1-image/edit",
  "prompt": "Replace the perfume bottle with a lipstick, keep the same lighting and background, photorealistic",
  "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%2Fhidream-o1-image%2Fedit",
  "title": "HiDream O1 Edit generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/hidream-o1-image/edit.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/hidream-o1-image/edit",
      "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"
    },
    "num_inference_steps": {
      "title": "Steps",
      "description": "Number of denoising steps. More = higher quality, slower.",
      "default": 50,
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "multipleOf": 1
    },
    "guidance_scale": {
      "title": "Guidance Scale",
      "description": "Classifier-free guidance scale. Higher = more faithful to prompt.",
      "default": 5,
      "type": "number",
      "minimum": 0,
      "maximum": 20,
      "multipleOf": 0.1
    },
    "keep_original_aspect": {
      "title": "Keep Original Aspect",
      "description": "When one reference image is provided, preserve its aspect ratio for the output.",
      "default": false,
      "type": "boolean"
    },
    "enable_safety_checker": {
      "title": "Safety Checker",
      "description": "Filter potentially unsafe content from the output.",
      "default": true,
      "type": "boolean"
    },
    "output_format": {
      "title": "Output Format",
      "description": "Output image format.",
      "default": "png",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ]
    },
    "seed": {
      "title": "Seed",
      "description": "Random seed for reproducible generation.",
      "type": "integer"
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "Custom"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "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
}

Browse schemas for every ArtEmotion model →

FAQ

How much does HiDream O1 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 HiDream O1 Edit fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call HiDream O1 Edit from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/hidream-o1-image/edit". 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 HiDream O1 Edit?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.