Import a shared asset
import_assetImport one image or song up to 32 MiB: an attached file (file), or a public https link (url, for Claude and hosts with no attachments). logo: true marks the brand’s logo. Returns an asset_staging_key for create_video’s asset_staging_keys (or music_staging_key for a song), good for seven days. Not for footage (edit_video).
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": {
"operation_id": "<operation_id>"
},
"name": "import_asset"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | A public https link to the image (PNG, JPEG, WebP, GIF) or song (MP3, WAV, M4A), up to 32 MiB: the file itself, not a page that shows it. | |
| file | No | A file attached in ChatGPT. Hosts that cannot attach files send url instead. | |
| logo | No | true when the image is the brand's logo: the video uses it as the brand's mark. | |
| file_name | No | A name for the file. | |
| operation_id | Yes | Same id retries run once. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | ||
| cost | No | ||
| error | No | ||
| state | No | ||
| status | No | ||
| dry_run | No | ||
| message | No | ||
| plan_id | No | ||
| style_id | No | ||
| video_id | No | ||
| available | No | ||
| import_id | No | ||
| mime_type | No | ||
| output_id | No | ||
| studio_url | No | ||
| version_id | No | ||
| asset_staging_key | No |