Beta

AIジョブ取得

GEThttps://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 を返します。

dataobject
AIジョブ
data.idstring
AIジョブID

例: AXABCDEFGHIJKLMN

data.statusstring
ANALYZING: 生成の準備中、PROCESSING: 生成中、COMPLETED: 完了、FAILED: 失敗、CANCELED: キャンセル

指定できる値: ANALYZINGPROCESSINGCOMPLETEDFAILEDCANCELED

例: COMPLETED

data.outputTypestring
出力形式。DOCUMENT: 以前のドキュメントジョブ

指定できる値: DOCUMENTPDFMARKDOWNIMAGEVIDEO3DMUSICTTSSTT

例: VIDEO

data.outputModelstring?
モデルID

例: kling-3.0

data.lastErrorCodestring?
直近の失敗コード。失敗コードを参照

例: null

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_UNAVAILABLEAIサービスの一時的な障害
PROVIDER_REJECTEDAIサービスがリクエスト内容を拒否
PROVIDER_TASK_FAILEDAIサービスの生成タスクが失敗
RESULT_UNAVAILABLE生成は完了したが、結果ファイルを取得または保存できなかった
CONTENT_BLOCKEDAIサービスの安全ポリシーによるブロック
COMPILER_STOPPEDリクエスト内容では生成できないと判定
OUTPUT_LIMIT_REACHEDドキュメントが出力上限に達して完了しなかった
INPUT_CHANGE_REQUIREDADVANCED の入力をモデルのルールに合わせて変更する必要がある
STORAGE_LIMIT_EXCEEDED結果を保存するワークスペースの容量が不足
EXECUTION_TIMEOUT実行時間の超過
INTERNAL_ERRORその他のサーバーエラー