> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Tasks API의 연동 및 사용

> Grok API guide - Ace Data Cloud

Grok Tasks API의 주요 기능은 Grok Videos Generation API에서 생성된 작업 ID를 입력하여 해당 작업의 실행 상태를 조회하는 것입니다.

본 문서는 Grok Tasks API의 연동 설명을 자세히 소개하여, 여러분이 Grok Videos Generation API의 작업 실행 상태를 쉽게 통합하고 조회할 수 있도록 돕습니다.

## 신청 절차

Grok Videos Generation API를 사용하려면 먼저 [Ace Data Cloud 콘솔](https://platform.acedata.cloud/console/applications)에서 API Token을 받아야 하며, 이를 보관해 두시기 바랍니다.

![](https://cdn.acedata.cloud/dvc3cg.jpg)

로그인이나 등록이 되어 있지 않은 경우, 자동으로 로그인 페이지로 리디렉션되어 등록 및 로그인을 요청합니다. 완료 후 현재 페이지로 자동으로 돌아옵니다.

**하나의 API Token으로 플랫폼의 모든 서비스를 호출할 수 있으며, 각 서비스마다 별도로 신청할 필요가 없습니다.** 처음 신청 시 무료 할당량이 제공되어 무료로 체험할 수 있으며, 할당량이 부족할 경우 [콘솔](https://platform.acedata.cloud/console/coin)에서 일반 잔액을 충전할 수 있습니다.

> 📘 전체 문서: [Grok Videos Generation API →](https://platform.acedata.cloud/documents/grok-videos)

## 요청 예시

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

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

**Request Headers**에는 다음이 포함됩니다:

* `accept` : JSON 형식의 응답 결과를 수신하도록 지정하며, 여기서는 `application/json`으로 입력합니다.
* `authorization` : API 호출에 필요한 키로, 신청 후 바로 선택할 수 있습니다.

**Request Body**에는 다음이 포함됩니다:

* `id` : 조회할 작업 ID.
* `action` : 작업의 조작 방식으로, 단일 조회 시 `retrieve`를 입력합니다.

### CURL 코드 예시

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/grok/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "action": "retrieve"
}'
```

### 응답 예시

요청이 성공하면 API는 해당 작업의 세부 정보를 반환합니다. 여기서 `request` 필드는 작업을 시작할 때의 request body이며, `response` 필드는 작업 완료 후 반환된 response body입니다. 예를 들어:

```json theme={null}
{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "started_at": 1769262721.823,
  "finished_at": 1769262729.623,
  "elapsed": 7.8,
  "request": {
    "prompt": "햇빛이 비치는 정원에서 나비를 쫓는 아기 고양이의 영화 같은 장면",
    "model": "grok-imagine-video-1.5-fast:reverse",
    "resolution": "480p",
    "duration": 8
  },
  "type": "videos",
  "response": {
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
      {
        "id": "grok-imagine-video-1.5-fast:reverse:41eb9a5f-3b2d-4d1e-9f5a-6c2f1a0b9e77",
        "video_url": "https://cdn.acedata.cloud/c8cbf53aa0.mp4",
        "state": "succeeded"
      }
    ]
  }
}
```

필드 설명은 다음과 같습니다:

* `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`를 입력합니다.

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/grok/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["b8976e18-32dc-4718-9ed8-1ea090fcb6ea"],
  "action": "retrieve_batch"
}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.