xAI · 影片

Hermes Agent x Grok Imagine

Grok Imagine 是 xAI 以 Grok 為基礎打造的創作 AI 套件，涵蓋圖片與影片生成。透過 RunAPI，所有 Grok Imagine 端點共用一組 API 金鑰。

7 variants 起價 $0.02 / 秒 可商用
取得 API Key 查看 Hermes Agent 文件

Prerequisite: npx runapi mcp install

Prompt

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: 輸入圖片作為第 1 個影格；以動作與鏡頭運動讓畫面動起來
  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 preview；支援文字／圖片輸入；自動畫面比例；最長 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。
GET /api/v1/grok_imagine/edit_image/<task-id>，直到狀態為 completed 或 failed。
確認 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。
GET /api/v1/grok_imagine/segment_map/<task-id>，直到狀態為 completed 或 failed。
確認 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。
GET /api/v1/grok_imagine/text_to_image/<task-id>，直到狀態為 completed 或 failed。
確認 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。
GET /api/v1/grok_imagine/image_to_video/<task-id>，直到狀態為 completed 或 failed。
確認 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。
GET /api/v1/grok_imagine/text_to_video/<task-id>，直到狀態為 completed 或 failed。
確認 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
使用流程

三步開始使用

  1. 選擇模型 ID

    選擇公開模型 ID，並查看其端點與目前起始價格。

  2. 設定 RunAPI

    呼叫端點前設定 RUNAPI_API_KEY。

  3. 驗證結果

    對非同步端點輪詢同一路徑，直到 Task 進入終態。

使用 Hermes Agent + Grok Imagine 可以打造什麼

  • AI 產生的商品照

    根據文字描述產生商品照，用於電商商品頁、產品型錄或廣告活動，不必實際拍攝。

  • 社群媒體影片片段

    用文字提示詞產生短影片片段，用於短影音、新品預告或內容行銷。

  • 創意專案的角色設計

    為遊戲、故事或品牌專案設計寫實或動漫風格的一致角色。

為什麼透過 RunAPI + Hermes Agent 使用 Grok Imagine

  • 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 Key 閱讀快速入門

正在與團隊一起打造？

我們可以協助企業接入、整合與技術問題。

聯絡我們