Skip to content

Image assets ​

Image media assets is used to reuse photo files in photo editing, image-to-image, video reference and multistep creation. For official business, use the stable public network URL, which is stored by the client; MoonNexAI OSS uploads only for joint testing, without guaranteeing long-term preservation or continued availability.

Common entry ​

MethodologyPathPurpose
POST/v1/assets/uploadsUpload pictures media assets.
GET/v1/assetsQuery media assets list.
GET/v1/assets/{asset_id}Find media assets details.

Upload Example ​

bash
curl https://moonnexai.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -F "file=@./product.png" \
  -F "type=image" \
  -F "purpose=image_reference" \
  -F "mode=oss"

Access Recommendations ​

  • Picture editing and hybrid maps can be used directly as public URLs or uploaded as hosting URLs.
  • Multiple re-uses of pictures suggest the preservation of media assets ID, URL, filename and use.
  • After the user deletes media assets, the synchronous side should update the reference status and avoid continuing to submit invalid URLs.

Relevant Pages ​