Grok Imagine 1.0

リクエスト ID grok-imagine-1.0

プロトコル

POST /v1/images/generations · 画像を生成の例
GET /v1/images/tasks/{task_id} · 画像タスクを照会の例

認証

リクエストには API キー管理の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。

Authorization: Bearer YOUR_API_KEY

リクエストパラメータ

`POST /v1/images/generations`

項目	型	必須	説明
`model`	`string`	必須	このモデル ID を指定します `grok-imagine-1.0`.
`prompt`	`string`	必須	生成したい画像を説明します。
`aspect_ratio`	`string`	任意	出力画像のアスペクト比です。指定可能な値 `1:1`, `16:9`, `9:16`, `3:2`, `2:3`. 既定値 `1:1`.
`n`	`integer`	任意	1 リクエストあたりの画像枚数です。1 枚の結果には `1` を指定します。既定値 `1`.
`?async`	`string`	任意	URL のクエリパラメータです。`1`、`true`、`yes` で `202` と `task_id` を返します。省略時は結果を待ちます。

リクエスト例

API Key をローカルの環境変数 ICODEEASY_API_KEY に設定し、直接 HTTP 呼び出しに対応するエンドポイントを選択します。指定クライアントが必要な場合は設定ガイドに従ってください。

例のメディア URL とアセット ID は、有効な素材に置き換えてください。

Images Generations

bash

curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "grok-imagine-1.0",
  "prompt": "A watercolor illustration of a paper lantern by a lake."
}'

画像タスクを照会

bash

curl -sS 'https://api.icodeeasy.cc/v1/images/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

レスポンスとタスク

HTTP 200 · 同期リクエストの成功

?sync=1 を指定した場合、画像 URL は data[].url から取得できます。created は UNIX 秒、id はタスク ID です。

json

{
  "id": "d142c93a-de26-40c9-be62-0de840d10960",
  "created": 1781599773,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

HTTP 202 · 非同期リクエストの受付

json

{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "pending"
}

?async=1 を指定した場合は、同じ API キーで GET /v1/images/tasks/{task_id} をポーリングします。status は pending、completed、failed のいずれかです。完了後は result_url から画像 URL を取得できます。

HTTP 200 · 完了したタスクの取得

json

{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "completed",
  "model": "grok-imagine-1.0",
  "result_url": "https://example.com/generated-image.png"
}