---
title: creative_media_imports_create
description: creative フラグが有効な接続先ワークスペースに、TikTok または Instagram の公開動画を取り込みます。
canonical_url: https://orchestor.io/docs/mcp/tools/creative/creative_media_imports_create
markdown_url: https://orchestor.io/docs/mcp/tools/creative/creative_media_imports_create.md
contentType: reference
---

# creative_media_imports_create

`creative` フラグが有効な接続先ワークスペースに、TikTok または Instagram の公開動画を取り込みます。

**操作** 書き込み。読み取りと書き込みを許可した OAuth 接続が必要です。

## パラメーター

| パラメーター | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `body` | オブジェクト | はい | メディア取込の入力。 |
| `body.url` | 文字列 | はい | TikTok または Instagram の公開動画・リールの URL。 |
| `body.get_transcript` | 真偽値 | いいえ | TikTok が提供する文字起こしを取得します。Instagram では無視します。 |
| `body.source_media_url` | 文字列 | いいえ | 投稿元 CDN の動画 URL。取得できない場合は投稿 URL から取得します。 |
| `body.mode` | 文字列 | いいえ | `async`（既定）、`sync`、`subscribe`、`webhook` のいずれか。 |
| `body.webhook_url` | 文字列 | いいえ | 終了通知を受け取る公開 HTTPS URL。`webhook` モードでは必須。 |
| `body.wait_timeout_seconds` | 整数 | いいえ | `sync` と `subscribe` の HTTP 待機時間。0〜30 秒で、既定は 30 秒。 |
| `body.project_id` | 文字列 | いいえ | 接続先ワークスペースの保存先プロジェクト ID。 |
| `idempotency_key` | 文字列 | はい | 同じ入力で再試行する場合は同じキーを使います。 |
| `approval_receipt` | 文字列 | いいえ | プランの承認後に渡すレシート。 |

承認後、同じ入力と `approval_receipt` を送信します。`data.job.id` を `creative_jobs_wait` に渡します。終了後、`data.media_import_id` を `creative_media_imports_get` の `path.id` に指定します。取込に Creative クレジットはかかりません。

ログインせずに再生できる公開動画を指定します。取り込める MP4 は最大 50 MiB、300 秒です。ログインが必要な投稿の取込は失敗し、`error.code` に `provider_submission_failed`、`error.public_reason` に `source_login_required` が返ります。

## 依頼例

```text
この Instagram の公開リールをワークスペースに取り込み、動画素材として使えるまで待ってください。
```

[クリエイティブ](https://orchestor.io/docs/mcp/tools/creative.md) · [Tools](https://orchestor.io/docs/mcp/tools.md)

---

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