AIジョブ取得
GET
https://api.youvico.com/api/files/:id/ai-job- MCPツール
- 未対応
- レート制限
- Default
- スコープ
- files:read
ファイル生成で作成したファイルのAIジョブを取得します。AIジョブがあるのは、AIで生成したファイルだけです。
例
curl 'https://api.youvico.com/api/files/FXABCDEFGHIJKLMN/ai-job' \
-H 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"id": "AXABCDEFGHIJKLMN",
"status": "COMPLETED",
"outputType": "VIDEO",
"outputModel": "kling-3.0",
"lastErrorCode": null,
"lastErrorMessage": null,
"configs": {
"start": "GA1234567890ABCD",
"durationSeconds": 10
},
"unusedAttachments": [],
"createdAt": "2026-04-10 08:20:00.318204",
"updatedAt": "2026-04-10 08:23:41.52",
"endedAt": "2026-04-10 08:23:41.52",
"canceledAt": null
}
}
リクエスト
curl -X GET 'https://api.youvico.com/api/files/FXABCDEFGHIJKLMN/ai-job' \
-H 'Authorization: Bearer YOUR_API_KEY'
レスポンス200 OK
{
"data": {
"id": "AXABCDEFGHIJKLMN",
"status": "COMPLETED",
"outputType": "VIDEO",
"outputModel": "kling-3.0",
"lastErrorCode": null,
"lastErrorMessage": null,
"configs": {
"start": "GA1234567890ABCD",
"durationSeconds": 10
},
"unusedAttachments": [],
"createdAt": "2026-04-10 08:20:00.318204",
"updatedAt": "2026-04-10 08:23:41.52",
"endedAt": "2026-04-10 08:23:41.52",
"canceledAt": null
}
}
リクエスト
パス
idstringrequiredファイルID
レスポンス
200 OK を返します。
dataobjectAIジョブ
data.idstringAIジョブID
例: AXABCDEFGHIJKLMN
data.statusstringANALYZING: 生成の準備中、PROCESSING: 生成中、COMPLETED: 完了、FAILED: 失敗、CANCELED: キャンセル
指定できる値: ANALYZINGPROCESSINGCOMPLETEDFAILEDCANCELED
例: COMPLETED
data.outputTypestring出力形式。DOCUMENT: 以前のドキュメントジョブ
指定できる値: DOCUMENTPDFMARKDOWNIMAGEVIDEO3DMUSICTTSSTT
例: VIDEO
data.outputModelstring?モデルID
例: kling-3.0
data.lastErrorMessagestring?ユーザーに表示する失敗理由。リクエストの言語で翻訳
例: null
data.configsobject?生成リクエストの configs で固定した設定
data.unusedAttachmentsarray結果に使用できなかった参考ファイル。ジョブが終わるまでは空の配列
data.createdAtstring作成日時
例: 2026-04-10 08:20:00.318204
data.updatedAtstring最終更新日時
例: 2026-04-10 08:23:41.52
data.endedAtstring?終了日時
例: 2026-04-10 08:23:41.52
data.canceledAtstring?キャンセル日時
例: null
失敗コード
| コード | 意味 |
|---|---|
SERVICE_UNAVAILABLE | AIサービスの一時的な障害 |
PROVIDER_REJECTED | AIサービスがリクエスト内容を拒否 |
PROVIDER_TASK_FAILED | AIサービスの生成タスクが失敗 |
RESULT_UNAVAILABLE | 生成は完了したが、結果ファイルを取得または保存できなかった |
CONTENT_BLOCKED | AIサービスの安全ポリシーによるブロック |
COMPILER_STOPPED | リクエスト内容では生成できないと判定 |
OUTPUT_LIMIT_REACHED | ドキュメントが出力上限に達して完了しなかった |
INPUT_CHANGE_REQUIRED | ADVANCED の入力をモデルのルールに合わせて変更する必要がある |
STORAGE_LIMIT_EXCEEDED | 結果を保存するワークスペースの容量が不足 |
EXECUTION_TIMEOUT | 実行時間の超過 |
INTERNAL_ERROR | その他のサーバーエラー |