cURL (upload)
Images
Replace an image
Three replacement modes:
- Upload —
multipart/form-datawith afilepart. Synchronous; returns the updatedImage. 1 credit (image_register). Max 10MB; jpg/jpeg/png/webp/gif/svg only. - Direct URL —
application/jsonwith{ url }. Synchronous; returns the updatedImage. 1 credit (image_register). - Regenerate —
application/jsonwith{ regenerate: true, prompt, ... }. Returns aJoband replaces the image when complete. 32 credits (image).
PUT
cURL (upload)
Authorizations
Project API key. Pass as Authorization: Bearer ndsk_live_.... Manage
keys via /projects/me/api-keys. Test-mode keys use
the ndsk_test_ prefix.
Path Parameters
Image key (any URL-safe identifier).
Example:
"hero.background"
Body
Image file (jpg/jpeg/png/webp/gif/svg). Max 10MB.
Response
Image replaced synchronously (upload or url mode).