Docs
My API keys ↗中文
Documentation/Models & APIs

Images & editing

Create images from text or references and retrieve URLs or Base64 data.

Updated October 7, 2026View Markdown ↗

Build a request

Parameters and request examples update for the selected model.

GPT Image 2

gpt-image-2
ParameterValues & requirements
qualitylow / auto → 1K; medium → 2K; high → 4K
n1
sizeWIDTHxHEIGHT; dimensions must be multiples of 8 and within the selected tier’s pixel budget.
image[]Upload 1–4 images to the edits endpoint.
Changing parameters only generates code. No requests or charges.
POST /v1/images/generations
curl --fail-with-body 'https://noveadream.com/v1/images/generations' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "A ceramic teapot on a sunlit table",
  "aspect_ratio": "1:1",
  "quality": "medium",
  "n": 1,
  "response_format": "url"
}'

GPT Image 2.5 SFW

gpt-image-2.5-sunburst
ParameterValues & requirements
qualitylow / auto → 1K
n1
sizeMultiples of 16; 655,360–1,048,576 pixels, aspect ratio within 3:1, each side at most 3840.
image[]Upload 1–4 images to the edits endpoint.
Changing parameters only generates code. No requests or charges.
POST /v1/images/generations
curl --fail-with-body 'https://noveadream.com/v1/images/generations' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "A ceramic teapot on a sunlit table",
  "aspect_ratio": "1:1",
  "quality": "low",
  "n": 1,
  "response_format": "url"
}'

Seedream 5.0 Pro

seedream-5.0-pro
ParameterValues & requirements
qualitylow / auto → 1K; medium → 2K
aspect_ratio1:1 / 16:9 / 9:16 / 4:3 / 3:4
n1
image_urls / image[]1–10 images; smart aspect ratio requires reference images.
Changing parameters only generates code. No requests or charges.
POST /v1/images/generations
curl --fail-with-body 'https://noveadream.com/v1/images/generations' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "seedream-5.0-pro",
  "prompt": "A ceramic teapot on a sunlit table",
  "aspect_ratio": "1:1",
  "quality": "low",
  "n": 1,
  "response_format": "url"
}'

Qwen Edit 2511

qwen-edit-2511
ParameterValues & requirements
modereference
image_urls / image[]Required, 1–2 images.
resolutionFixed at 720p; quality does not change resolution.
n1
Changing parameters only generates code. No requests or charges.
POST /v1/images/generations
curl --fail-with-body 'https://noveadream.com/v1/images/generations' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "qwen-edit-2511",
  "prompt": "Change the background to a quiet garden",
  "mode": "reference",
  "aspect_ratio": "1:1",
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "n": 1,
  "response_format": "url"
}'

NovelAI V4.5

nai-v4.5
Read the integration guide →
ParameterValues & requirements
n1–4
aspect_ratioMapped to server-defined dimensions.
image[]Exactly one reference for editing.
qualityNot applicable; see the NovelAI guide for detailed controls.
Changing parameters only generates code. No requests or charges.
POST /v1/images/generations
curl --fail-with-body 'https://noveadream.com/v1/images/generations' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "nai-v4.5",
  "prompt": "watercolor, a quiet garden",
  "aspect_ratio": "1:1",
  "n": 1,
  "response_format": "url"
}'

NovelAI V5

nai-v5
Read the integration guide →
ParameterValues & requirements
modelnai-diffusion-5-full
actiongenerate / img2img / infill
parameters.steps1–50
parameters.n_samples1–4
parameters.v4_prompt.caption.char_captionsUp to 32; automatic positioning recommended.
Changing parameters only generates code. No requests or charges.
POST /ai/generate-image
curl --fail-with-body 'https://noveadream.com/ai/generate-image' \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -d '{
  "model": "nai-diffusion-5-full",
  "input": "watercolor, a quiet garden",
  "action": "generate",
  "parameters": {
    "width": 1024,
    "height": 1024,
    "steps": 23,
    "n_samples": 1,
    "scale": 5,
    "seed": 42,
    "negative_prompt": ""
  }
}'

Nano Banana 2

nano-banana-2-sfw
Read the integration guide →
ParameterValues & requirements
APIWorkspace only; public API unavailable.
resolution1K / 2K / 4K
aspect_ratiosmart / 1:1 / 3:2 / 2:3 / 4:3 / 3:4 / 5:4 / 4:5 / 16:9 / 9:16 / 21:9
ReferencesUp to 14 account-owned images.
Image count1

Common parameters

FieldDescription
modelRequired. A model ID available to your key.
promptRequired. Describe the desired image.
nImage count. Start with 1.
size / qualitySupported sizes and quality levels vary by model.
response_formaturl | b64_json
image_urlsPublic reference URLs, supported by selected models.

Edit reference images

POST /v1/images/edits
curl --fail-with-body https://noveadream.com/v1/images/edits \
  -H "Authorization: Bearer $NOVEA_API_KEY" \
  -H "Idempotency-Key: $REQUEST_ID" \
  -F "model=gpt-image-2" \
  -F "prompt=Change the background to a quiet garden" \
  -F "image[]=@reference.png"

Let your client set the multipart Content-Type boundary; do not set application/json. Repeat image[] for multiple files.

Read the result

JSON · Example
{
  "created": 1791300000,
  "data": [{ "url": "https://example.com/result.png" }]
}

For b64_json responses, read data[].b64_json. Download results promptly rather than treating result URLs as permanent storage.