Grok Videos Generation API 대결 설명

​

신청 절차

📘 전체 문서: Grok Videos Generation API →

​

모델 설명

• grok-imagine-video-1.5-fast:reverse (기본값): 문생 비디오(오직 prompt만 전달)와 그림생 비디오(image_url 전달)를 지원하며, 길이는 6–30초로, 길이에 따라 요금이 부과되며 가장 저렴합니다.
• grok-imagine-video:reverse: 문생 및 그림생 비디오를 지원하며, 길이는 1–15초로, 출력 초수에 따라 요금이 부과됩니다.
• grok-imagine-video:official: 공식 엔드포인트로, 문생 및 그림생 비디오를 지원하며, 길이는 1–15초로, 출력 초수에 따라 요금이 부과되며 화질이 더 높습니다.
• grok-imagine-video-1.5:official: 공식 엔드포인트로, 오직 그림생 비디오만 지원하며, 반드시 image_url을 전달해야 하며, 길이는 1–15초로, 최대 1080p를 지원하며 출력 초수에 따라 요금이 부과됩니다.

​

기본 사용

• accept: 어떤 형식의 응답 결과를 받고 싶은지, 여기서는 application/json으로 작성하여 JSON 형식으로 설정합니다.
• authorization: API를 호출하는 키로, 신청 후 바로 드롭다운에서 선택할 수 있습니다.

• prompt: 생성하고자 하는 비디오 내용에 대한 텍스트 프롬프트입니다. 문생 비디오를 만들 때 필수이며, image_url을 전달할 때는 선택 사항입니다.
• model: 비디오를 생성할 모델로, 선택할 수 있는 값은 grok-imagine-video-1.5-fast:reverse (기본값), grok-imagine-video:reverse, grok-imagine-video:official 또는 grok-imagine-video-1.5:official입니다.
• image_url: 그림생 비디오의 입력 이미지 링크입니다. model이 grok-imagine-video-1.5:official일 때 필수입니다.
• reference_image_urls: 비디오의 스타일이나 내용을 안내하기 위한 선택적 참조 이미지 링크 배열입니다.
• aspect_ratio: 생성할 비디오의 가로 세로 비율로, 선택할 수 있는 값은 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3입니다.
• resolution: 출력 해상도로, 선택할 수 있는 값은 480p (기본값), 720p 또는 1080p입니다.
• duration: 생성할 비디오의 길이(초)입니다. grok-imagine-video-1.5-fast:reverse의 경우 6–30의 값을 가지며, 나머지 모델은 1–15의 값을 가집니다. 기본값은 6입니다. 6초 또는 10초를 사용하는 것이 추천되며, 이 두 표준 길이는 상대적으로 안정적입니다.
• callback_url: 비동기 콜백 주소로, 설정 후 API는 즉시 task_id를 반환하며, 작업이 완료되면 결과를 해당 주소로 POST합니다.
• async: 선택 사항으로, true로 설정하면 인터페이스가 즉시 task_id를 반환하며, callback_url을 제공할 필요가 없고, 이후 해당 작업 조회 인터페이스를 통해 결과를 폴링하여 얻을 수 있습니다.

{
  "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"
    }
  ]
}

• success: 이번 비디오 생성 요청이 성공했는지 여부입니다.
• task_id: 이번 비디오 생성 작업의 ID입니다.
• trace_id: 이번 요청의 추적 ID로, 문제를 해결하는 데 사용됩니다.
• data: 생성된 비디오 결과 목록입니다.
  • id: 생성된 비디오의 고유 식별자입니다.
  • video_url: 생성된 비디오의 링크 주소입니다.
  • state: 비디오 생성 작업의 상태로, 선택할 수 있는 값은 pending / succeeded / failed입니다.

curl -X POST 'https://api.acedata.cloud/grok/videos' \
-H 'authorization: Bearer ${bearer_token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
  "prompt": "A cinematic shot of a kitten chasing a butterfly in a sunlit garden",
  "model": "grok-imagine-video-1.5-fast:reverse",
  "resolution": "480p",
  "duration": 6
}'

import requests

url = "https://api.acedata.cloud/grok/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "prompt": "A cinematic shot of a kitten chasing a butterfly in a sunlit garden",
    "model": "grok-imagine-video-1.5-fast:reverse",
    "resolution": "480p",
    "duration": 6
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​

그림생 비디오

{
  "prompt": "The character slowly turns around and smiles at the camera",
  "model": "grok-imagine-video-1.5:official",
  "image_url": "https://cdn.acedata.cloud/5hmkdg.jpg",
  "resolution": "720p",
  "duration": 6
}

​

참조 이미지 안내

{
  "prompt": "A character dancing in the same art style",
  "model": "grok-imagine-video-1.5-fast:reverse",
  "reference_image_urls": [
    "https://cdn.acedata.cloud/vunnjf.png"
  ]
}

​

비동기 콜백

{
  "prompt": "햇빛이 비치는 정원에서 나비를 쫓는 새끼 고양이의 영화 같은 장면",
  "model": "grok-imagine-video-1.5-fast:reverse",
  "duration": 6,
  "callback_url": "https://your-domain.com/callback/grok"
}

{
  "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea"
}

​

작업 결과 조회

​

요금 설명

• grok-imagine-video-1.5-fast:reverse: 시간에 따라 요금이 부과되며, 해상도와는 무관합니다 — 6–10 초, 11–20 초, 21–30 초는 각각 다른 요금 구간에 해당합니다.
• grok-imagine-video:reverse: “출력 초수”에 따라 요금이 부과되며, 총 가격 = 단가 × duration입니다.
• grok-imagine-video:official 및 grok-imagine-video-1.5:official: 공식 엔드포인트로, “출력 초수”에 따라 요금이 부과되며, 해상도가 높을수록 단가가 높습니다; 공식 모델은 내용 검토에 실패하더라도 요금이 부과됩니다.

​

오류 처리

• 400: 요청 매개변수가 잘못되었습니다. 예를 들어 비디오 생성에 prompt가 누락되었거나, grok-imagine-video-1.5:official에 image_url이 누락되었거나, duration이 범위를 초과했습니다 (grok-imagine-video-1.5-fast:reverse는 6–30, 나머지 모델은 1–15).
• 401: 인증 실패, 토큰이 유효하지 않거나 API와 일치하지 않습니다.
• 403: 잔액 부족 또는 프롬프트가 내용 검토에 의해 거부되었습니다.
• 429: 요청이 너무 빈번합니다. 잠시 후 다시 시도하십시오.
• 500: 비디오 생성 실패 또는 서비스 이상.