Skip to main content
POST
プロジェクトの詳細、編集可能な設定、セグメントのリビジョン、出力 URL、翻訳バージョンを取得します。

認証と権限

string
必須
このヘッダーに VoiceCheap API キーを指定してください。同じ API キーを Authorization: Bearer で送信することもできます。OAuth アクセストークンは MCP でのみ使用でき、この REST エンドポイントでは使用できません。
必要な権限: projects:read. 有効な有料サブスクリプションが必要です。権限によってチーム内のロール、リソースの所有権、メディアクレジット、プランの制限が変わることはありません。

パラメーター

string
必須
テキスト値。最小文字数: 1. 最大文字数: 200. パターン: ^[^/\\]+$.
以下の JSON Schema は、ディスカバリーで公開される正確なフィールド名、ネストされた型、デフォルト値、範囲、許容値を保持しています。フィールド間の追加ルールは操作の注意事項に記載されています。

リクエスト例

例に記載されたリソース識別子とメディアキーを、ご自身のアカウントで返された値に置き換えてください。同じ変更操作を再試行する場合は、リクエスト識別子を変更しないでください。

レスポンス

初回実行が成功すると、操作結果を data に格納して HTTP 200 を返します。同じリクエストを再送した場合は、代わりに保存済みリクエストの状態を返すことがあります。例はサポートされるレスポンスの一例であり、すべての任意フィールドを示すものではありません。 公開用のプロジェクト詳細、顧客設定、現在のソース構造リビジョン、すべての翻訳出力バージョンを返します。

結果フィールド

操作の注意事項

  • このアクションは文字起こしテキストや生のセグメントドキュメントを返しません。文字起こしの内容には transcripts_get、言語別ワークのメタデータには translations_list を使用してください。
  • 存在しない任意のネストフィールドは、シリアライズされた JSON から省略されます。出力 URL は、対応する出力が利用可能になるまで空文字列です。
  • プロジェクトのステータスは、ワークフローと最新の翻訳バージョンを要約します。複数の言語を管理する場合は、translations[] の各項目を確認してください。
  • error フィールドは保存済みの処理エラーを示します。失敗したプロジェクトを正常に取得できた場合も、通常の結果を返します。
  • 保存された失敗は、VoiceCheap のエラーコードと固定メッセージを返します。コードとリソースの現在の状態を使って、復旧方法を判断してください。

使用量

正常に実行された呼び出しごとに、月間 API/MCP 呼び出し回数を 1 回消費します。メディアクレジットと、その操作固有の生成枠も適用されます。

エラー