Asset resources
Use stable public media URLs directly when the generation API supports them. Use an asset reference only when the target model supports or requires one.
Upload, query and use
- Upload with the actual target
modelandmode=asset; keep your source URL accessible. - Save the returned MoonNexAI
asset_idandasset_ref. - Query details for the same ID. While syncing, detail queries attempt to continue the existing synchronization.
- After readiness is confirmed, explicitly include the reference in the generation request's supported media field.
Before using an asset reference, require status=ready, preparation_status=ready and generation_ready=true, and confirm that the model selected during upload supports the reference. review_status / review_passed provide additional status information; they do not replace readiness. Resolve a reported review failure or error first. An available OSS URL does not establish Asset:// support for every model.
Files and project organization
Local files can use multipart mode=oss for a hosted test URL. MoonNexAI OSS is for testing and has no long-term retention or availability guarantee. Use storage you control for production media. More modes and batch uploads are in advanced options.
Groups organize your own media. Asset management edits names, moves assets and disables records. None of these operations automatically attaches media to a generation task.