画像・音声・動画・Realtime
モデルとチャネルの対応状況を確認してから API を選択してください。
利用できる機能
実際に利用できる機能は、アカウント、モデル、チャネルの設定によって異なります。まず /v1/models を確認し、選択したモデルのエンドポイント、パラメーター、料金、利用枠をコンソールまたはサポートで確認してください。
| 機能 | エンドポイント | 利用条件 |
|---|---|---|
| 画像生成 | POST /v1/images/generations | 対応モデル、チャネル、または設定済みタスクプラグインが必要 |
| 画像編集 | POST /v1/images/edits | multipart／JSON、参照画像、マスク、サイズ、出力形式を確認 |
| 文字起こし | POST /v1/audio/transcriptions | 対応する音声モデルが必要。ファイル形式とサイズはチャネルごとに異なる |
| 音声翻訳 | POST /v1/audio/translations | 対象モデルの対応状況を確認 |
| 音声合成 | POST /v1/audio/speech | 対応 TTS モデルが必要。音色、エンコード、ストリーミングはチャネルごとに異なる |
| 動画タスク | POST /v1/videos、GET /v1/videos/:task_id | 対応する動画チャネル／タスクプラグインが必要。提供元ごとにパラメーターが異なる場合がある |
| 動画結果 | GET /v1/videos/:task_id/content | 権限のある完了済みタスクが必要。利用可否はタスクのプロトコルによる |
| Realtime | wss://api.aimirrorx.com/v1/realtime?model=MODEL_ID | Realtime 対応チャネル、モデル、WebSocket クライアントが必要 |
| Responses WebSocket | wss://api.aimirrorx.com/v1/responses | Responses 専用プロトコル。Realtime 音声プロトコルとは異なる |
画像生成の例
選択したモデルが OpenAI Images プロトコルに対応していることを確認してから実行してください。
curl https://api.aimirrorx.com/v1/images/generations \
-H "Authorization: Bearer $AIMIRRORX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"MODEL_ID_FROM_V1_MODELS","prompt":"一座安静的海边灯塔","n":1}'結果はプロトコルとチャネルによって、URL、base64 データ、非同期タスクオブジェクトなどになります。送信成功は生成完了を意味しません。結果が不明なタスクを自動で再送しないでください。有効期限、結果のダウンロード、ポーリング間隔、課金は選択したサービスの実際の動作に従います。
音声と動画
音声アップロードでは通常 multipart を使い、音声合成では通常バイナリが返されます。すべてのレスポンスをテキスト JSON として解析しないでください。動画生成は、送信、タスク ID の保存、状態のポーリング、結果のダウンロードという流れです。提供元のネイティブパスが異なる場合は、そのチャネルで明示されたプロトコルを使用してください。このガイドは汎用の動画パラメーターテンプレートや利用開始の保証を提供するものではありません。
WebSocket とブラウザー
サーバー側 WebSocket クライアントは、API の要件に従って Bearer 認証を送信できます。ブラウザー標準の WebSocket API では任意のリクエストヘッダーを設定できません。長期 API キーを Web ページのコードや URL に公開しないでください。管理されたサーバー側の接続方式を用意し、提供元固有の一時セッションキー、WebRTC、すべてのイベント形式への対応を前提にしないでください。
対応を前提にしない機能
/v1/images/variations、Files、Fine-tunes など、一部の上流 API は現在未対応です。管理 API には別の管理権限が必要です。顧客用トークンでチャネル、ユーザー、課金設定の管理を試みないでください。上流のプラグインマーケットは参考資料です。ドキュメントサービスはプラグインのインストールや API 実行のプロキシを提供しません。