翻訳 API
最先端のAIを使用して字幕を100以上の言語に翻訳し、リーチを拡大します。
POST
/api/v1/translateクイック実装
curl -X POST https://api.srtgen.com/api/v1/translate \ -H "x-api-key: <YOUR_API_KEY>" \ -F "projectId=proj_8k2n9m1b" \ -F "targetLanguageCode=es" \ -F "modelId=pro"
POSThttps://api.srtgen.com/api/v1/translate
リクエストパラメータ
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
projectId | String | Yes | 翻訳するプロジェクトの一意の識別子。 |
targetLanguageCode | String | Yes | ISO 639-1コード (例: 'es', 'fr', 'zh-CN')。 |
modelId | String | No | 'pro' (高品質、1クレジット/分) または 'basic' (高速、1クレジット/2分)。デフォルトは 'basic' です。 |
高度: 基本モデル (コスト最適化)
curl -X POST https://api.srtgen.com/api/v1/translate \ -H "x-api-key: <YOUR_API_KEY>" \ -F "projectId=proj_8k2n9m1b" \ -F "targetLanguageCode=zh-CN" \ -F "modelId=basic"
POSThttps://api.srtgen.com/api/v1/translate
成功レスポンス
200 OK ステータスを返します。翻訳された字幕はすぐに同期され、ワークスペースでの書き出しやさらなる修正が可能になります。
{ "success": true, "projectId": "proj_8k2n9m1b", "targetLanguageCode": "es", "modelId": "pro" }
エラーコード
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
| 400 | missing_parameter | プロジェクトIDまたはターゲット言語が欠落しています。 | |
| 401 | unauthorized | APIキーが欠落しているか無効です。 | |
| 404 | not_found | プロジェクトIDが存在しません。 | |
| 403 | insufficient_balance | 操作に必要なクレジットが不足しています。 | |
| 500 | translation_failed | AIエンジンがリクエストの処理に失敗しました。 | |
| 500 | server_error | 予期しない内部サーバーエラーが発生しました。 |
エラーレスポンス構造
{ "success": false, "error": "not_found", "message": "ID 'proj_unknown' のプロジェクトが見つかりませんでした。" }
このページは役に立ちましたか?