Skip to main content
Gemini Tasks API의 주요 기능은 Gemini Videos Generation API에서 생성된 작업 ID를 입력하여 해당 작업의 실행 상태를 조회하는 것입니다. 본 문서는 Gemini Tasks API의 연동 설명을 자세히 소개하여 귀하가 Gemini Videos Generation API의 작업 실행 상태를 쉽게 통합하고 조회할 수 있도록 돕습니다.

​
신청 절차

Gemini Videos Generation API를 사용하려면 먼저 Ace Data Cloud 콘솔에서 API Token을 받아야 하며, 이를 보관해 두십시오. 로그인 또는 등록이 되어 있지 않은 경우, 자동으로 로그인 페이지로 리디렉션되어 등록 및 로그인을 초대합니다. 완료 후 현재 페이지로 자동으로 돌아옵니다. 하나의 API Token으로 플랫폼의 모든 서비스를 호출할 수 있으며, 각 서비스마다 별도로 신청할 필요가 없습니다. 최초 신청 시 무료 할당량이 제공되어 무료로 체험할 수 있으며, 할당량이 부족할 경우 콘솔에서 일반 잔액을 충전할 수 있습니다.
📘 전체 문서: Gemini Videos Generation API →

​
요청 예시

Gemini Tasks API는 Gemini Videos Generation API의 결과를 조회하는 데 사용할 수 있습니다.

​
요청 헤더 및 요청 본문 설정

Request Headers에는 다음이 포함됩니다:
  • accept: JSON 형식의 응답 결과를 수신하도록 지정하며, 여기에는 application/json을 입력합니다.
  • authorization: API 호출에 필요한 키로, 신청 후 직접 드롭다운에서 선택할 수 있습니다.
Request Body에는 다음이 포함됩니다:
  • id: 조회할 작업 ID입니다.
  • action: 작업의 조작 방식으로, 단일 조회 시 retrieve를 입력합니다.

​
CURL 코드 예시

​
응답 예시

요청이 성공하면 API는 해당 작업의 세부 정보를 반환합니다. 여기서 request 필드는 작업을 시작할 때의 request body이며, response 필드는 작업 완료 후 반환된 response body입니다. 예를 들어:
필드 설명은 다음과 같습니다:
  • id: 생성된 작업의 ID로, 이번 생성 작업을 고유하게 식별하는 데 사용됩니다.
  • request: 작업 조회 시의 요청 정보입니다.
  • response: 작업 조회 시의 반환 정보입니다.
  • created_at: 작업 생성 시간, Unix 타임스탬프(초, 부동 소수점).
  • started_at: 작업 시작 실행 시간, Unix 타임스탬프(초, 부동 소수점).
  • finished_at: 작업 완료 시간, Unix 타임스탬프(초, 부동 소수점). 작업이 완료되지 않은 경우 이 필드는 반환되지 않습니다.
  • elapsed: 작업 실행 소요 시간, 단위는 초(부동 소수점, 소수점 3자리). 작업이 완료되지 않은 경우 이 필드는 반환되지 않습니다.

​
배치 조회 작업

여러 작업 ID에 대한 작업 세부 정보를 조회할 때는 action을 retrieve_batch로 설정하고 ids를 통해 작업 ID 배열을 전달합니다: Request Body에는 다음이 포함됩니다:
  • ids: 조회할 작업 ID 배열입니다.
  • action: 작업의 조작 방식으로, 배치 조회 시 retrieve_batch를 입력합니다.