Beta

AI 작업 조회

GEThttps://api.youvico.com/api/files/:id/ai-job
MCP 도구
미지원
요청 제한
Default
API 권한
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그 밖의 서버 오류