AI 작업 조회
GET
https://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를 반환합니다.
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 | 그 밖의 서버 오류 |