xAI · 비디오

Hermes Agent x Grok Imagine

Grok Imagine은 Grok을 기반으로 구축된 xAI의 크리에이티브 AI 스위트로, 이미지 및 비디오 생성을 제공합니다. RunAPI를 통해 모든 Grok Imagine 엔드포인트가 단일 API 키를 공유합니다.

7 variants 최저 $0.02 / 초 상업적 사용 지원
API 키 받기 Hermes Agent 문서 보기

Prerequisite: npx runapi mcp install

Prompt

프롬프트 모델

작업에 맞는 경우 grok-imagine-edit-image를 사용하세요: 하나 이상의 소스 이미지로 프롬프트 기반 스타일 전환 및 구성 편집.

You have access to RunAPI task tools for Grok Imagine.

Available Grok Imagine models:
- grok-imagine-edit-image: 하나 이상의 소스 이미지로 프롬프트 기반 스타일 전환 및 구성 편집
  endpoints: /api/v1/grok_imagine/edit_image
  request fields: model, source_image_url, prompt
- grok-imagine-image-2-0: 텍스트-이미지 생성, 세그멘테이션 맵 및 정밀 이미지 편집
  endpoints: /api/v1/grok_imagine/edit_image, /api/v1/grok_imagine/segment_map, /api/v1/grok_imagine/text_to_image
  request fields: model, prompt, aspect_ratio
- grok-imagine-image-to-video: 입력 이미지가 첫 프레임; 모션과 카메라로 애니메이션
  endpoints: /api/v1/grok_imagine/image_to_video
  request fields: model, source_image_url, prompt
- grok-imagine-text-to-image: Aurora 모델; 5가지 화면 비율; 사실적/예술적/애니메이션 스타일
  endpoints: /api/v1/grok_imagine/text_to_image
  request fields: model, prompt
- grok-imagine-text-to-video: 동기화된 네이티브 오디오와 립싱크가 포함된 텍스트-비디오 6–30초
  endpoints: /api/v1/grok_imagine/text_to_video
  request fields: model, prompt
- grok-imagine-video-1.5-fast: 빠른 반복 제작을 위한 고속 텍스트·이미지 기반 영상 생성
  endpoints: /api/v1/grok_imagine/image_to_video, /api/v1/grok_imagine/text_to_video
  request fields: model, prompt
- grok-imagine-video-1.5-preview: Video 1.5 프리뷰; 텍스트/이미지 입력; auto 화면 비율; 최대 15초
  endpoints: /api/v1/grok_imagine/image_to_video, /api/v1/grok_imagine/text_to_video
  request fields: model, prompt

Use the model ID and endpoint that match the user's request.
Example prompt: 체스 말을 체스판 위에 놓는 로봇 손의 짧은 영상을 극적인 조명과 슬로우 모션으로 생성해 주세요.
/api/v1/grok_imagine/edit_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/grok_imagine/edit_image를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/grok_imagine/edit_image/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/grok_imagine/segment_map: Submit the task, poll for its status, then verify the completed output. POST /api/v1/grok_imagine/segment_map를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/grok_imagine/segment_map/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/grok_imagine/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/grok_imagine/text_to_image를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/grok_imagine/text_to_image/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/grok_imagine/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/grok_imagine/image_to_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/grok_imagine/image_to_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/grok_imagine/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/grok_imagine/text_to_video를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/grok_imagine/text_to_video/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.

공개 버전 및 엔드포인트

모델 ID 엔드포인트 시작 가격 모델 카탈로그
grok-imagine-edit-image
/api/v1/grok_imagine/edit_image
$0.04 / 회 모델 상세
grok-imagine-image-2-0
/api/v1/grok_imagine/edit_image /api/v1/grok_imagine/segment_map /api/v1/grok_imagine/text_to_image
$0.04 / 회 모델 상세
grok-imagine-image-to-video
/api/v1/grok_imagine/image_to_video
$0.02 / 초 모델 상세
grok-imagine-text-to-image
/api/v1/grok_imagine/text_to_image
$0.04 / 회 모델 상세
grok-imagine-text-to-video
/api/v1/grok_imagine/text_to_video
$0.02 / 초 모델 상세
grok-imagine-video-1.5-fast
/api/v1/grok_imagine/image_to_video /api/v1/grok_imagine/text_to_video
$0.57 / 회 모델 상세
grok-imagine-video-1.5-preview
/api/v1/grok_imagine/image_to_video /api/v1/grok_imagine/text_to_video
$0.08 / 초 모델 상세

검증

Task가 최종 상태에 도달할 때까지 폴링합니다

<model-id>를 선택하면 검증 명령을 생성합니다.

설정

가이드 엔드포인트: <endpoint>

<model-id>를 선택하면 엔드포인트의 공개 입력 계약에 맞는 요청을 생성합니다.

추가 작업

이 작업들은 모델 ID를 사용하지 않습니다.

  • /api/v1/grok_imagine/extend_video
  • /api/v1/grok_imagine/upscale_image
사용 절차

3단계로 시작하기

  1. 모델 ID 선택

    공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.

  2. RunAPI 설정

    엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.

  3. 결과 검증

    비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.

Hermes Agent + Grok Imagine로 만들 수 있는 것

  • AI로 생성한 제품 사진

    텍스트 설명으로 전자상거래 상품 페이지, 카탈로그, 광고 캠페인에 쓸 제품 사진을 촬영 없이 만듭니다.

  • 소셜 미디어용 영상 클립

    텍스트 프롬프트로 릴스, 제품 티저, 콘텐츠 마케팅에 쓸 짧은 영상 클립을 생성합니다.

  • 창작 프로젝트용 캐릭터

    게임, 스토리, 브랜드 프로젝트를 위해 사실적인 스타일이나 애니메이션 스타일의 일관된 캐릭터를 디자인합니다.

Grok Imagine을(를) RunAPI + Hermes Agent로 사용하는 이유

  • 7개 변형 모델, 하나의 API 키

    하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.

  • 명확한 사용 요금

    요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.

  • 자동화된 작업 워크플로

    수동 폴링 코드를 작성하지 않고 일관된 작업 흐름으로 비동기 결과를 제출하고 확인하고 수집하세요.

Hermes Agent + Grok Imagine 자주 묻는 질문

Hermes Agent에서 Grok Imagine을 사용할 수 있나요?

네. RunAPI가 이미 Hermes Agent의 공급자로 설정되어 있다면 같은 API 키로 Grok Imagine을 사용할 수 있습니다. 이 페이지에 표시된 버전과 엔드포인트를 선택하세요.

Grok 구독이 필요한가요?

아니요. RunAPI를 통한 Grok Imagine은 작업 단위로 RunAPI 잔액에서 과금됩니다. 별도의 Grok 요금제나 계정은 필요 없습니다.

Hermes Agent가 Grok Imagine을 다른 이미지 모델과 함께 사용할 수 있나요?

네. Hermes Agent는 Grok Imagine으로 초안을 만든 뒤 같은 워크플로에서 결과를 편집 모델이나 업스케일 모델에 넘길 수 있으며, RunAPI 키 하나로 모두 처리합니다.

어떤 모델 ID를 사용해야 하나요?

버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.

이 가이드는 채팅 모델을 설정하나요?

아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다.

Hermes Agent에서 Grok Imagine 사용 시작하기

API 키 받기 빠른 시작 읽기

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기