---
title: Orchestor Creative API
description: 画像と動画を、共通の認証と非同期リクエストで生成します。
canonical_url: https://orchestor.io/docs/creative
markdown_url: https://orchestor.io/docs/creative.md
contentType: guide
---

# Orchestor Creative API

モデルと入力を送信し、状態確認または Webhook で完了を受け取ります。

- **[最初の生成を実行する](https://orchestor.io/docs/creative/quickstart.md)**
  API キーの設定から結果の取得まで進めます。

- **[認証を設定する](https://orchestor.io/docs/creative/authentication.md)**
  サーバーから API キーを使って接続します。

## リクエスト例

### 動画

```bash
curl --request POST https://api.orchestor.io/v1/creative/video-router/generate \
  --header "Authorization: Bearer $ORCHESTOR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data '{"model":"seedance-2.5","prompt":"白い背景に置かれた青いガラスの花瓶","duration":5,"mode":"async"}'
```

### 画像

```bash
curl --request POST https://api.orchestor.io/v1/creative/image-router/generate \
  --header "Authorization: Bearer $ORCHESTOR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data '{"model":"gpt-image-2","prompt":"白い背景に置かれた青いガラスの花瓶","mode":"async"}'
```

API キーと冪等性キーの設定方法は[クイックスタート](https://orchestor.io/docs/creative/quickstart.md)を参照してください。受付時の `data.job.id` と `status_url` を保存し、完了後に `result_url` から成果物を取得します。

受付時の応答例（必要な項目の抜粋）です。

```json
{
  "data": {
    "job": { "id": "job_example", "status": "queued" },
    "status_url": "https://api.orchestor.io/v1/creative/jobs/job_example/status",
    "result_url": "https://api.orchestor.io/v1/creative/jobs/job_example/result"
  }
}
```

## 次に進む

- **[プロトタイプを作る](https://orchestor.io/docs/creative/client.md)**
  Python・Node.js から送信し、結果を取得します。

- **[本番運用に備える](https://orchestor.io/docs/creative/concepts/requests.md)**
  状態遷移、ポーリング、通知、エラー、制限を確認します。

- **[メディアをアップロードする](https://orchestor.io/docs/creative/uploads.md)**
  生成に使用する入力ファイルをアップロードします。

> **成果物を保存する**
> 
> 長期保存が必要な成果物は、自分のストレージへダウンロードしてください。[料金とデータ保持](https://orchestor.io/docs/creative/concepts/billing-and-retention.md)で保持条件を確認できます。

## 関連ページ

- [API の仕組み](https://orchestor.io/docs/creative/how-to/introduction.md)
- [モデル API リファレンス](https://orchestor.io/docs/creative/models.md)
- [API リファレンス](https://orchestor.io/docs/creative/rest-api.md)

---

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