신청 절차
Grok Videos Generation API를 사용하려면 먼저 Ace Data Cloud 콘솔에서 API Token을 받아야 하며, 이를 보관해 두시기 바랍니다.
로그인이나 등록이 되어 있지 않은 경우, 자동으로 로그인 페이지로 리디렉션되어 등록 및 로그인을 요청합니다. 완료 후 현재 페이지로 자동으로 돌아옵니다.
하나의 API Token으로 플랫폼의 모든 서비스를 호출할 수 있으며, 각 서비스마다 별도로 신청할 필요가 없습니다. 처음 신청 시 무료 할당량이 제공되어 무료로 체험할 수 있으며, 할당량이 부족할 경우 콘솔에서 일반 잔액을 충전할 수 있습니다.
📘 전체 문서: Grok Videos Generation API →
요청 예시
Grok Tasks API는 Grok Videos Generation API의 결과를 조회하는 데 사용할 수 있습니다.요청 헤더 및 요청 본문 설정
Request Headers에는 다음이 포함됩니다:accept: JSON 형식의 응답 결과를 수신하도록 지정하며, 여기서는application/json으로 입력합니다.authorization: API 호출에 필요한 키로, 신청 후 바로 선택할 수 있습니다.
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를 입력합니다.