Skip to content
Model infoModelsSnapshot: 15 Oct 2026

Decart / Lucy Image

Lucy Image 2

Edits an existing image from a text instruction, with an optional visual reference and 480p or 720p output.

Image generation
availableClosed weightsImage editing
Official documentation (opens in a new tab)Reviewed 15 Oct 2026
10 of 25 specification fields collected
Output resolution480p, 720pSee specification notes below
Text input limit1K1,000
Input billingSee ratesDecart image API
Output billingSee ratesPublished units and conditions below

Specifications

Provider-documented facts. “Not collected” means we have not verified that field yet, not that the feature is unsupported.

Context / input limit
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Maximum input tokens
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Maximum output
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Reasoning
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Tool calling
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Structured output
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Streaming
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Batch processing
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Fine-tuning
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Knowledge cutoff
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Release date
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Parameters
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Architecture
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Languages
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Context caching
Not collected

Not established for this exact model and API. Media generation does not imply language-model token limits or capabilities.

Input modalities
Text, ImageSource for Input modalities (opens in a new tab)
Output modalities
ImageSource for Output modalities (opens in a new tab)
Output resolutions
480p, 720pSource for Output resolutions (opens in a new tab)
Output formats
PNGSource for Output formats (opens in a new tab)

HTTP image/png response. Example filenames ending in .jpg do not establish JPEG encoding.

Model aliases
lucy-image-latestSource for Model aliases (opens in a new tab)
Legacy API aliases
lucy-pro-i2iSource for Legacy API aliases (opens in a new tab)
Maximum prompt characters
1,000Source for Maximum prompt characters (opens in a new tab)

Pinned JavaScript SDK validation limit; REST OpenAPI does not publish this maximum.

Prompt length limit
JavaScript SDK: 1–1000 characters. REST: required prompt without a published maximum.Source for Prompt length limit (opens in a new tab)
Reference guidance
Required input image and prompt; optional reference_image.Source for Reference guidance (opens in a new tab)
Random seed
0–4294967295; optional.Source for Random seed (opens in a new tab)

Access & pricing

Prices belong to an endpoint and billing tier. A provider listing does not guarantee access for every account or region.

Decart image API

Provider source (opens in a new tab)
API model ID
lucy-image-2
Access
Native image-editing API; account and API key required. No image generation requested.
Regions
Not established
API endpoint URL
POST https://api.decart.ai/v1/generate/lucy-image-2Source for API endpoint URL (opens in a new tab)
Authentication
X-API-KEY header; multipart form data.Source for Authentication (opens in a new tab)
Processing workflow
Synchronous image response. SDK metadata includes a queue path, but the reviewed REST schema does not document that image-job route.Source for Processing workflow (opens in a new tab)
Output pixel presets
Guide gives 480×832 and 720×1280 examples. SDK carries 1280×704 metadata; exact orientation/shape mapping is unresolved.Source for Output pixel presets (opens in a new tab)
Prompt expansion
enhance_prompt defaults to true; resolution defaults to 720p.Source for Prompt expansion (opens in a new tab)
Billing basis
Per image generation, priced by selected resolution.Source for Billing basis (opens in a new tab)

Prices retain their published currencies and billing units below.

Published billing units · original currency · observed 15 Oct 2026
CategoryUsageRateUnit
Media generation480p image edit1$0.01generation
Media generation720p image edit1$0.02generation

Rate conditions

  1. One image edit at the selected resolution; not a per-token tariff.
Pricing source (opens in a new tab)

Data & enterprise terms

Reviewed API terms permit input/output use for service improvement and training, and do not treat them as confidential. Enterprise-specific overrides were not reviewed.

Read the service policy (opens in a new tab)

Caching

Caching can reuse earlier input processing. Availability, lifetime and billing depend on the endpoint. A cache hit still generates a new response.

01 / INITIAL INPUTProcess & retain

The system processes eligible input and retains reusable state.

02 / LATER REQUESTCheck available state

Reuse depends on matching input, session state and the cache policy.

03 / CACHE HITReuse & generate

Reusing state can reduce repeated work. Any charges follow the billing rules below.

Decart image API

lucy-image-2
Not verified

No model prompt-cache contract or cache discount established. Upload reuse, client-token expiry and stateful video context are separate mechanisms.

How it works
Not collected

No model prompt-cache contract or cache discount established. Upload reuse, client-token expiry and stateful video context are separate mechanisms.

Minimum reusable input
Not collected

No model prompt-cache contract or cache discount established. Upload reuse, client-token expiry and stateful video context are separate mechanisms.

Lifetime & refresh
Not collected

No model prompt-cache contract or cache discount established. Upload reuse, client-token expiry and stateful video context are separate mechanisms.

How to enable it
Not collected

No model prompt-cache contract or cache discount established. Upload reuse, client-token expiry and stateful video context are separate mechanisms.

Usage fields
Not collected

No model prompt-cache contract or cache discount established. Upload reuse, client-token expiry and stateful video context are separate mechanisms.

Billing rules
Not collected

No model prompt-cache contract or cache discount established. Upload reuse, client-token expiry and stateful video context are separate mechanisms.

Limits & data boundaries
Not collected

No model prompt-cache contract or cache discount established. Upload reuse, client-token expiry and stateful video context are separate mechanisms.

No verified cache rate for this endpoint. An empty rate is not a zero charge.

Caching reviewed 15 Oct 2026

What the measurements say

No benchmark observations have been added for this model. We do not turn a vendor description into a performance score.

Latency and throughput depend on the host, request size, reasoning settings and load. There is no measured speed or global usage figure in this record.

The record behind the model

Why it is included

The provider names this hosted model, retains rights in its models and limits access through its API. No matching checkpoint appears in the reviewed official public-weight inventory. Closed-weight classification is an inference from these sources; it is not applied to Lucy Edit Dev releases or public SDK code.

Classification evidence (opens in a new tab)

Sources reviewed