curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-APIMart-Response-Version: 2026-07-27' \
--data '{
"model": "grok-imagine-image-2.0",
"prompt": "雨の夜、ネオンに照らされた映画のような都市の通り",
"n": 1,
"aspect_ratio": "16:9",
"resolution": "2k",
"quality": "medium"
}'
{
"code": 202,
"data": {
"id": "task_01KZQE5CM0Y3KZ6M1N1BK619MX",
"object": "generation.task",
"type": "image",
"status": "pending",
"progress": 0,
"poll_url": "/v1/tasks/task_01KZQE5CM0Y3KZ6M1N1BK619MX"
}
}
Grok Imagine 2.0 Ext
Grok Imagine Image 2.0 公式画像生成・編集
grok-imagine-image-2.0 による非同期の画像生成と編集
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-APIMart-Response-Version: 2026-07-27' \
--data '{
"model": "grok-imagine-image-2.0",
"prompt": "雨の夜、ネオンに照らされた映画のような都市の通り",
"n": 1,
"aspect_ratio": "16:9",
"resolution": "2k",
"quality": "medium"
}'
{
"code": 202,
"data": {
"id": "task_01KZQE5CM0Y3KZ6M1N1BK619MX",
"object": "generation.task",
"type": "image",
"status": "pending",
"progress": 0,
"poll_url": "/v1/tasks/task_01KZQE5CM0Y3KZ6M1N1BK619MX"
}
}
本エンドポイントは非同期方式です。送信成功後にタスク ID が返されます。タスク状態の取得をポーリングして最終結果を取得してください。
image_urls を省略するとテキストから画像生成、指定すると画像編集またはマルチ画像参照になります。curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-APIMart-Response-Version: 2026-07-27' \
--data '{
"model": "grok-imagine-image-2.0",
"prompt": "雨の夜、ネオンに照らされた映画のような都市の通り",
"n": 1,
"aspect_ratio": "16:9",
"resolution": "2k",
"quality": "medium"
}'
{
"code": 202,
"data": {
"id": "task_01KZQE5CM0Y3KZ6M1N1BK619MX",
"object": "generation.task",
"type": "image",
"status": "pending",
"progress": 0,
"poll_url": "/v1/tasks/task_01KZQE5CM0Y3KZ6M1N1BK619MX"
}
}
モデル機能
| モデル | 解像度 | quality | 入力画像 | 出力枚数 |
|---|---|---|---|---|
grok-imagine-image-2.0 | 1k、2k | テキストから画像生成時のみ low、medium | 0~3 枚 | 1~10 枚 |
Body
string
デフォルト:"grok-imagine-image-2.0"
必須
固定値:
grok-imagine-image-2.0。boolean
デフォルト:"false"
画像タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
true:omni-moderation-latestでプロンプトと入力画像を審査falseまたは省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
画像生成または編集の指示。トリム後に空でないこと。最大 8,000 文字です。
integer
デフォルト:"1"
出力枚数。
1~10。string
デフォルト:"auto"
1:1、3:4、4:3、9:16、16:9、2:3、3:2、9:19.5、19.5:9、9:20、20:9、1:2、2:1、auto に対応します。string
デフォルト:"1k"
1k または 2k。string
テキストから画像生成時のみ
low または medium(デフォルト)。image_urls がある場合は送信しないでください。array
参考画像 1~3 枚。公開アクセス可能な絶対 HTTP(S) URL のみ対応します。ローカル画像は先に
POST /v1/uploads/images へアップロードし、返された url を使用してください。非同期タスク
送信成功時は HTTP202 で、タスク ID は data.id にあります。data.poll_url または GET /v1/tasks/{task_id} を使用し、completed または failed になるまで照会してください。
長期有効な API キーをブラウザーコード、公開環境変数、URL、ローカルストレージ、クライアントログに含めないでください。バックエンドまたは BFF から呼び出してください。