---
title: creative jobs
description: 生成ジョブの状態、成果物、履歴を確認し、キュー待ちのジョブを取り消します。
canonical_url: https://orchestor.io/docs/cli/creative/jobs
markdown_url: https://orchestor.io/docs/cli/creative/jobs.md
contentType: reference
---

# creative jobs

`orc creative jobs` は、`image generate`、`video generate`、`tts generate`、`voice change` が作成したジョブを扱います。`jobs status` で状態を、`jobs result` で成果物を取得し、`jobs events` で状態の履歴を確認します。

ジョブは `COMPLETED`、`FAILED`、`CANCELED` のいずれかで終わります。取り消せるのはキュー待ちのジョブだけです。状態確認の間隔は[ポーリング](https://orchestor.io/docs/creative/concepts/polling.md)を参照してください。

## 使い方

```bash title="terminal"
orc creative jobs status <id> --json
```

*ジョブの状態を確認します。*

```bash title="terminal"
orc creative jobs result <id> --json
```

*完了したジョブの成果物を取得します。*

## サブコマンド

### `list`

ジョブを一覧表示

```bash title="terminal"
orc creative jobs list [options]
```

#### 固有のオプション

##### `--type`

取得する生成ジョブの種類。省略するとすべての種類を取得します。

型: `string`。任意。

```bash title="terminal"
orc creative jobs list --type <value>
```

##### `--types`

複数の種類をまとめて取得する場合に、types=image-router&types=video-router のように繰り返して指定します。type と同時には指定できません。; csv

型: `string`。任意。

```bash title="terminal"
orc creative jobs list --types <value>
```

##### `--status`

取得するジョブの処理状態。; enum: queued|processing|completed|failed|canceled

型: `string`。任意。

```bash title="terminal"
orc creative jobs list --status <value>
```

##### `--starting-after`

前のページの next_cursor。省略すると新しいジョブから取得します。

型: `string`。任意。

```bash title="terminal"
orc creative jobs list --starting-after <value>
```

### `get`

ジョブを取得

```bash title="terminal"
orc creative jobs get <id> [options]
```

### `status`

ジョブの状態を取得

```bash title="terminal"
orc creative jobs status <id> [options]
```

### `result`

ジョブの結果を取得

```bash title="terminal"
orc creative jobs result <id> [options]
```

### `events`

ジョブのイベントを一覧表示

```bash title="terminal"
orc creative jobs events <id> [options]
```

### `cancel`

ジョブをキャンセル

```bash title="terminal"
orc creative jobs cancel <id> [options]
```

## 使用例

### Workspace の失敗したジョブを一覧します。

```bash title="terminal"
orc creative jobs list --status failed --json
```

*Workspace の失敗したジョブを一覧します。*

### 状態の履歴を確認します。

```bash title="terminal"
orc creative jobs events <id> --json
```

*状態の履歴を確認します。*

### キュー待ちのジョブを取り消します。

```bash title="terminal"
orc creative jobs cancel <id>
```

*キュー待ちのジョブを取り消します。*

## 必要な権限

CLI の認証（`orc auth login` または `ORCHESTOR_API_KEY`）と、対象 Workspace へのアクセスが必要です。 ジョブの取り消しには書き込み権限が必要です。

## グローバルオプション

`orc creative jobs` では、次の[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を使用できます。

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%98%E3%83%AB%E3%83%97)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#%E5%87%BA%E5%8A%9B%E5%BD%A2%E5%BC%8F)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#%E5%80%A4%E3%81%A0%E3%81%91%E3%82%92%E5%87%BA%E5%8A%9B)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%B8%E3%81%AE%E5%87%BA%E5%8A%9B)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%9A%E3%83%BC%E3%82%B8%E9%80%81%E3%82%8A)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E4%BA%8B%E5%89%8D%E7%A2%BA%E8%AA%8D)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#%E7%A2%BA%E8%AA%8D%E3%81%AE%E7%9C%81%E7%95%A5)
- [`--limit`](https://orchestor.io/docs/cli/global-flags.md)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#%E3%81%99%E3%81%B9%E3%81%A6%E3%81%AE%E3%83%9A%E3%83%BC%E3%82%B8%E3%82%92%E5%8F%96%E5%BE%97)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E6%99%82%E9%96%93)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#%E8%AA%AD%E3%81%BF%E5%8F%96%E3%82%8A%E5%B0%82%E7%94%A8%E3%83%A2%E3%83%BC%E3%83%89)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#%E5%A4%96%E9%83%A8%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E7%9B%AE%E5%8D%B0%E4%BB%98%E3%81%91)

各オプションの詳細と使用例は、[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を参照してください。

---

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