Grok 5 Imagine 生成

API ドキュメンテーション

これらのエンドポイントを使用して、Grok 5 Imagine ジョブを送信し、ステータスを確認します。各呼び出しでは、使用するモデルに基づいてクレジットが消費されます。

認証

すべてのリクエストには、API キーを Authorization header:

Authorization: Bearer <YOUR_API_KEY>

キーがないか無効な場合は、 401 Unauthorized.

POST

https://grok5imagine.com/api/generate

生成タスクの作成

新しい Grok 5 Imagine ジョブを送信します。この呼び出しは、レンダリングが非同期で完了する間、すぐに task_id を返します。

パラメータ	タイプ	必須	説明
model	string	いいえ	使用するモデル：grok-imagine/text-to-image（デフォルト）、text-to-video、image-to-video、または upscale。
input	object	はい	モデルに応じて prompt、image_urls、または task_id を含む入力パラメータオブジェクト。
input.prompt	string (max 5000 chars)	いいえ	生成するものを説明するテキストプロンプト（text-to-image と text-to-video に必須）。
input.image_urls	string[]	いいえ	画像 URL の配列（image-to-video に必須）。
input.task_id	string	いいえ	アップスケールまたは image-to-video 生成用の以前のタスク ID。
callback_url	string	いいえ	タスク完了通知を受け取るための Webhook URL。
public	boolean	いいえ	タスクを公開ギャラリーに公開します。

クレジット消費

クレジットはタスク作成時に差し引かれます。失敗したジョブは自動的に返金されます。

モデル	差し引かれたクレジット
grok-imagine/text-to-image	5
grok-imagine/text-to-video	24
grok-imagine/image-to-video	24
grok-imagine/upscale	12

リクエスト例

{
  "model": "grok-imagine/text-to-image",
  "input": {
    "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
  }
}

レスポンス例

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "IN_PROGRESS"
  }
}

GET / POST

https://grok5imagine.com/api/status

タスクステータスの確認

このエンドポイントを使用して、最新のレコードをポーリングします。タスクがまだ IN_PROGRESS (進行中) の場合は、応答する前にもう一度プロバイダーに問い合わせます。

パラメータ	タイプ	必須	説明
task_id	string	はい	/generate から返された ID。クエリ（?task_id=）または JSON ボディ経由で送信します。

フィールド	説明
task_id	/generate から返された ID。
status	SUCCESS (成功)
request	送信されたペイロードのサニタイズされたコピー。
response	ステータスが SUCCESS の場合の resultUrls 配列を含むオブジェクト。
consumed_credits	タスクに対して請求されたクレジット（返金時は 0）。
error_message	ステータスが FAILED の場合のプロバイダーエラーメッセージ。
created_at	ジョブが保存されたときの UTC タイムスタンプ。

リクエスト例

GET https://grok5imagine.com/api/status?task_id=n31b6d54c8f4b4c4e8kie
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://grok5imagine.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "n31b6d54c8f4b4c4e8kie"
}

レスポンス例

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "SUCCESS",
    "request": {
      "model": "grok-imagine/text-to-image",
      "input": {
        "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
      }
    },
    "response": {
      "resultUrls": [
        "https://static.gogloai.com/grok-imagine/image_001.png"
      ]
    },
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

エラー処理

401 Unauthorized - API キーがないか無効です。
402 Payment Required - クレジット残高が控除額をカバーできませんでした。
429 Too Many Requests - ポーリング頻度またはリクエストレートを下げてください。
500 - 一時的な問題です。指数関数的バックオフで再試行してください。