---
title: ヘッダー
description: 画像・動画の生成とジョブ管理で使用するヘッダーとクエリパラメーターです。
canonical_url: https://orchestor.io/docs/creative/rest-api/headers
markdown_url: https://orchestor.io/docs/creative/rest-api/headers.md
contentType: reference
---

# ヘッダー

## リクエストヘッダー

| ヘッダー | 必須 | 対象 | 説明 |
| --- | --- | --- | --- |
| `Authorization` | はい | 各 API | `Bearer YOUR_API_KEY`。[認証](https://orchestor.io/docs/creative/authentication.md)を参照してください。 |
| `Content-Type` | 本文がある場合 | JSON 本文を送る API | `application/json`。 |
| `Idempotency-Key` | いいえ | 生成要求 | 1〜255文字の印字可能 ASCII。UUID を推奨します。同じキーと入力の再送は、元のジョブに結び付きます。[冪等性キー](https://orchestor.io/docs/creative/concepts/idempotency.md)を参照してください。 |

`x-api-key` でも認証できます。`Authorization` と同時に指定せず、どちらか一方を使用してください。

## クエリパラメーター

| パラメーター | 対象 | 説明 |
| --- | --- | --- |
| `limit` | ジョブ一覧・イベント取得 | 1ページで返す件数。操作ごとの上限を確認してください。 |
| `type` | ジョブ一覧 | 生成ジョブの種類で絞り込みます。 |
| `status` | ジョブ一覧 | ジョブの処理状態で絞り込みます。 |
| `starting_after` | ジョブ一覧 | 前の応答の `next_cursor`。先頭ページでは省略します。 |

Webhook の通知先はクエリではなく、生成要求の JSON 本文の `webhook_url` に指定します。`mode: "webhook"` と組み合わせてください。[Webhook](https://orchestor.io/docs/creative/webhooks.md)で送信例を確認できます。

## レスポンスヘッダー

| ヘッダー | 対象 | 説明 |
| --- | --- | --- |
| `x-orchestor-request-id` | API 応答 | HTTP 要求の相関 ID。生成ジョブの ID と分けて記録し、[問い合わせ](https://orchestor.io/docs/creative/help/support.md)に添えます。 |
| `ratelimit-limit` | レート制限情報を含む応答 | 現在の期間に許可される要求数。 |
| `ratelimit-remaining` | レート制限情報を含む応答 | 現在の期間に残っている要求数。 |
| `ratelimit-reset` | レート制限情報を含む応答 | 制限がリセットされるまでの秒数。 |
| `retry-after` | 再試行の待機時間を含む応答 | 次の試行まで待つ秒数。[レート制限](https://orchestor.io/docs/creative/concepts/rate-limits.md)を参照してください。 |
| `x-orchestor-poll-after` | ジョブ状態取得の応答 | 次の状態取得まで待つ秒数。 |

## Webhook 配信ヘッダー

Orchestor から受信先へ送る[Webhook](https://orchestor.io/docs/creative/webhooks.md)に付与します。

| ヘッダー | 説明 |
| --- | --- |
| `x-orchestor-webhook-timestamp` | 署名に使用した Unix 時刻（秒）。現在時刻との差が300秒以内か確認します。 |
| `x-orchestor-webhook-signature` | `orchestor-v1=` に続く HMAC-SHA256 の16進数。複数署名はカンマ区切りです。 |
| `x-orchestor-webhook-secret-fingerprint` | 署名シークレットの世代を識別する指紋。秘密値ではありません。 |

署名対象は `<timestamp>.<raw body>` です。本文を再シリアライズせず、受信時のバイト列を検証します。重複処理の防止には、検証済み本文の `job_id` を使用してください。

## 関連ページ

- [認証](https://orchestor.io/docs/creative/authentication.md)
- [よくある質問](https://orchestor.io/docs/creative/help/faq.md)
- [ファイルのアップロード](https://orchestor.io/docs/creative/uploads.md)
- [料金とデータ保持](https://orchestor.io/docs/creative/concepts/billing-and-retention.md)
- [Webhook](https://orchestor.io/docs/creative/webhooks.md)

---

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