API reference · Public
One video, sound or 3D model's sample
GET/api/media/sampleNo key
The file a model made, once, from the stated sample prompt. Cached for a year when asked with v, the first sixteen hex digits of its SHA-256, for five minutes without it. Byte ranges are answered. A model with no sample, or any request while the media jobs are off, is a 404.
Parameters
| Field | Type | What it is |
|---|---|---|
| id (query)required | string | A model id. |
| v (query) | string | The file's version. |
Answer 200
The file.
The answer's fields are not named in the document.
Answer 206
The byte range asked for.
The answer's fields are not named in the document.
Errors
- 404No sample.
- 416A range past the end.
Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.