Source: https://polysh.io/ja/agents/api/

> **Reading this as an agent?** This is the Markdown copy of a polysh.io page, written for people and agents alike. To learn what Polysh can do for you and your user, start at https://polysh.io/agents/, and use https://polysh.io/llms.txt for an index of every page. Agent features are in early access, so there's nothing to install yet; your user can join the waitlist at https://app.polysh.io/waitlist.

早期アクセス API

# 製品動画づくりを自社のツールに組み込む

Polysh API では、Web アプリと同じ処理を REST で利用できるようになります。録画を送信し、動画を作成し、言語を追加して、共有リンクを受け取るまでを、自社のコードから行えます。

[エージェントのウェイティングリストに登録](https://app.polysh.io/waitlist)[招待済みの方はログイン](https://app.polysh.io/sign-in)

早期アクセス。開発中です。

## API で提供予定の機能

### ワークスペースごとの API キー

Polysh を呼び出すサービスごとにキーを作成でき、ほかのキーに影響を与えずに 1 つだけ無効化できます。

### 完了した処理を通知する Webhook

ポーリングしなくても、動画の完了、失敗、キャンセル時に、指定したエンドポイントに通知が届きます。

### OpenAPI 仕様

お使いの言語でクライアントを生成したり、仕様をエージェントに渡してすべてのエンドポイントを把握させたりできます。

## リクエストの流れ

動画の処理は 1 つのリクエストで始まり、Webhook で終わります。以下のエンドポイント名とフィールドは説明用の例です。

**プレビュー：API はまだ提供されていません。**

- `recording: <upload id>`、`languages: en, es, ja`、`voice: <voice id per language>` を指定して `POST /videos`
- レスポンス：`202 Accepted { job_id }`
- 処理の完了時にエンドポイントへ届く Webhook：`event: video.export.succeeded`（`video_id, share_link, captions (srt, vtt), guide` を含む）

**n8n や Zapier のような自動化ツールでも使えますか？** 当初は対応していません。API と Webhook は、自動化ツールから処理を開始したり、完了時に反応したりできるよう設計しています。既製のコネクターを提供する際は、変更履歴でお知らせします。

## 今から連携を計画しましょう

エージェントのウェイティングリストにご登録ください。早期アクセスのチームには、OpenAPI 仕様を最初にお届けします。

[エージェントのウェイティングリストに登録](https://app.polysh.io/waitlist)[招待済みの方はログイン](https://app.polysh.io/sign-in)