Issue with File Upload API https://api.moonshot.ai/v1/files/{file_id}

Developer Support
1

I am trying upload video file. The file is uploaded correctly with status “created”. Polling the file status always return created.

I also upload the file through UI to test. It poll the file through UI. It never changes the status. It always stay created.

PROBLEM:

If I make model call for video analysis immediately after upload complete, I will get a very bad result.

How do I wait for the upload to be ready for processing?

EXAMPLE:

I uploaded the file through the UI

The file id is f9bzzdmjnrni11e99mei. I am limited to one image per post. Otherwise, I would have attach the screenshot here.

I check the status after 5 minutes. The status never change.

image
image1109×271 15.7 KB

2

Hi there,

Thank you for reaching out and sharing this feedback! We completely understand why the current status might be confusing.

To clarify what is happening behind the scenes:

  • "status": "created" actually means the file is already ready. We recognize that “created” implies it is still waiting to be processed. We are looking into updating this status to "ready" in the future to make it much more intuitive!
  • Uploads are synchronous by default. Because the process is non-async, as soon as your POST request returns a 200 OK status, the file is fully processed and ready to be used by the model. There is no need to poll or wait.
1 Like
3

Thank you for the information.

1 Like
4

Regarding large video files and future improvements:

For very large video files, the upload and preprocessing steps do indeed take some time to complete. Personally, I also feel that blocking on a synchronous POST request isn’t the safest or most developer-friendly approach—especially for substantial uploads or in environments with strict timeout constraints.

Rest assured, we are actively experimenting with asynchronous upload flows internally, weighing various tradeoffs between reliability, latency, and developer experience. We hope to offer a more flexible async option in the future that better handles these edge cases.

Please stay tuned for updates, and feel free to reach out if you encounter any other issues in the meantime.