---
title: creative files
description: Issue an upload URL so a local file can be used as generation input.
canonical_url: https://orchestor.io/docs/en/cli/creative/files
markdown_url: https://orchestor.io/docs/en/cli/creative/files.md
contentType: reference
---

# creative files

`orc creative files upload-url create` issues a signed URL for sending a file. `PUT` the file to the returned URL, then pass the returned public URL to an input such as `--image-urls`, `--image-url` or `--audio-url`.

See [Uploads](https://orchestor.io/docs/creative/uploads.md) for file types, sizes and retention.

## Usage

```bash title="terminal"
orc creative files upload-url create --content-type image/png --size-bytes 204800 --filename input.png --json
```

*Issue an upload URL for a PNG.*

## Subcommands

### `upload-url create`

アップロード URL を発行

```bash title="terminal"
orc creative files upload-url create [options]
```

#### Unique options

##### `--content-type`

(required) ファイルの MIME タイプ。例は image/png、video/mp4。

Type: `string`. Optional.

```bash title="terminal"
orc creative files upload-url create --content-type <value>
```

##### `--size-bytes`

(required) ファイルの正確なサイズ。単位はバイト。

Type: `number`. Optional.

```bash title="terminal"
orc creative files upload-url create --size-bytes <value>
```

##### `--filename`

元ファイルの名前。1〜255 文字。; max 255 chars

Type: `string`. Optional.

```bash title="terminal"
orc creative files upload-url create --filename <value>
```

## Examples

### Send the file to the issued URL.

```bash title="terminal"
curl -X PUT --upload-file input.png -H "Content-Type: image/png" "<upload-url>"
```

*Send the file to the issued URL.*

## Permissions

Requires CLI authentication (`orc auth login` or `ORCHESTOR_API_KEY`) and access to the target Workspace. Issuing a URL requires write access.

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc creative files`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#all-pages)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#read-only-mode)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#untrusted-content-wrapping)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

[Documentation index](https://orchestor.io/docs/llms.txt)
