Upload from a link
upload_from_urlTurn a hosted file URL into a single-use upload_ref: the server fetches, validates (type/size) and duration-probes it, returning an upload_ref to pass as a run file-input param. This is also the way to feed transcription/speech-to-text models from a URL, since they price by measured input length and a bare URL cannot be measured before the job runs.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "upload_from_url"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | a public http(s) URL to an image/video/audio file; it is fetched, validated (type/size) and duration-probed into a single-use upload_ref |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| media_type | Yes | ||
| upload_ref | Yes | ||
| duration_min | Yes |