curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "grok-imagine-image-2.0",
"prompt": "サイバーパンク風の夜の東京の街並み、濡れた路面に映るネオンの光"
}
'{
"created": 1757156493,
"id": "task-unified-1757156493-imcg5zqt",
"model": "grok-imagine-image-2.0",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 100
},
"type": "image",
"usage": {
"billing_rule": "per_call",
"credits_reserved": 3.06,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: grok-imagine-image-2.0",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Grok
Grok Imagine Image 2.0 画像生成
- Grok Imagine Image 2.0（grok-imagine-image-2.0）は xAI の画像生成・画像編集モデルで、テキストから画像への生成と画像編集が同じモデル名を共有します
image_urlsを指定しない場合はテキストから画像への生成、1~3枚の参照画像を渡すと自動的に画像編集モードに切り替わります（モデルの切り替えは不要）- 非同期処理モード、返却されたタスクIDで照会
- 生成された画像リンクは24時間有効です、お早めに保存してください
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "grok-imagine-image-2.0",
"prompt": "サイバーパンク風の夜の東京の街並み、濡れた路面に映るネオンの光"
}
'{
"created": 1757156493,
"id": "task-unified-1757156493-imcg5zqt",
"model": "grok-imagine-image-2.0",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 100
},
"type": "image",
"usage": {
"billing_rule": "per_call",
"credits_reserved": 3.06,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: grok-imagine-image-2.0",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}承認
##すべてのAPIにBearer Token認証が必要です##
APIキーの取得：
APIキー管理ページにアクセスしてAPIキーを取得してください
リクエストヘッダーに追加：
Authorization: Bearer YOUR_API_KEY
ボディ
application/json
画像生成モデル名。テキストから画像への生成と画像編集で同じモデル名を使用し、image_urls の有無によってモードが自動的に切り替わります
利用可能なオプション:
grok-imagine-image-2.0 例:
"grok-imagine-image-2.0"
生成したい画像、または渡した参照画像の編集方法を記述するプロンプト
複数画像の参照構文:
- 複数の参照画像を渡す場合、プロンプト内で
<IMAGE_0>、<IMAGE_1>、<IMAGE_2>を使って 1 枚目・2 枚目・3 枚目の参照画像をそれぞれ指定できます - インデックスは
0から始まり、image_urls配列の順序と 1 対 1 で対応します - 例:
<IMAGE_0> の人物を <IMAGE_1> のシーンに配置してください
例:
"サイバーパンク風の夜の東京の街並み、濡れた路面に映るネオンの光"
画像から画像への変換および画像編集機能のための参照画像URLリスト
注意:
- リクエストあたりの入力画像数:
0~3枚（指定なし = テキストから画像への生成、1~3枚 = 画像編集） - 公開ネットワークから直接アクセスできる
http/httpsの画像URLのみ対応。base64 および data URL は非対応です - サポートされるファイル形式:
.jpeg、.jpg、.png、.webp - 画像URLはサーバーから直接アクセス可能であるか、アクセス時に直接ダウンロードする必要があります（通常、これらのURLは
.png、.jpgなどの画像ファイル拡張子で終わります） - 画像編集の場合、渡した参照画像には追加費用が発生します。費用はリクエストごとに 1 回のみ計上され、
n倍にはなりません
Maximum array length:
3例:
[
"https://example.com/person.png",
"https://example.com/scene.png"
]
生成画像のアスペクト比。デフォルトは auto
対応する比率（13 種類）:
| 比率 | 説明 |
|---|---|
1:1 | 正方形 |
4:3 / 3:4 | 従来の横長 / 縦長 |
3:2 / 2:3 | 標準の横長 / 縦長 |
16:9 / 9:16 | ワイドスクリーン / スマホ縦長 |
2:1 / 1:2 | 超横長 / 超縦長 |
19.5:9 / 9:19.5 | フルスクリーンスマホ横 / 縦 |
20:9 / 9:20 | ウルトラワイド横 / 縦 |
注意:
auto: モデルが比率を自動的に決定します。パラメータを指定しない場合はautoと同等です（出力は通常縦長になります）- 上表以外の値には非対応です
利用可能なオプション:
1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, auto 例:
"16:9"
出力画像のピクセルレベル。デフォルトは 1K で、1K と 2K の 2 段階に対応
注意:
- 本モデルは
4Kに非対応です - 値は大文字小文字を区別しません
利用可能なオプション:
1K, 2K 例:
"1K"
生成品質のレベル。モデルの思考の深さを制御します。デフォルトは medium
| 値 | 説明 |
|---|---|
low | 生成が速く、コストが低い |
medium | 画質とディテールがより優れる |
注意:
- 本モデルは
low/mediumの 2 段階のみ対応。highなどの値には非対応です quality（品質レベル）とresolution（ピクセルレベル）は互いに独立しており、自由に組み合わせられます- 値は大文字小文字を区別しません
利用可能なオプション:
low, medium 例:
"medium"
生成する画像の枚数。範囲は 1~10、デフォルトは 1
注意:
- 画像ごとに個別に課金され、費用は
nに比例して増加します - 参照画像による追加費用はリクエストごとに 1 回のみ計上され、
n倍にはなりません
必須範囲:
1 <= x <= 10例:
1
タスク完了後の HTTPS コールバックアドレス
コールバックタイミング：
- タスクが完了、失敗、またはキャンセルされた時にトリガーされます
- 課金確認完了後に送信されます
セキュリティ制限：
- HTTPS プロトコルのみサポート
- 内部 IP アドレスへのコールバックは禁止（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x など）
- URL の長さは
2048文字以内
コールバックメカニズム：
- タイムアウト：
10秒 - 失敗時最大
3回リトライ（1秒/2秒/4秒後にリトライ） - コールバックレスポンスボディの形式はタスククエリ API のレスポンス形式と一致
- コールバックアドレスが 2xx ステータスコードを返した場合は成功とみなされ、その他のステータスコードはリトライをトリガーします
例:
"https://your-domain.com/webhooks/image-task-completed"
レスポンス
画像タスクが正常に作成されました
タスク作成タイムスタンプ
例:
1757156493
タスクID
例:
"task-unified-1757156493-imcg5zqt"
実際に使用されたモデル名
例:
"grok-imagine-image-2.0"
具体的なタスクタイプ
利用可能なオプション:
image.generation.task タスク進行状況のパーセンテージ (0-100)
必須範囲:
0 <= x <= 100例:
0
タスクステータス
利用可能なオプション:
pending, processing, completed, failed 例:
"pending"
非同期タスク情報
Show child attributes
Show child attributes
タスクの出力タイプ
利用可能なオプション:
text, image, audio, video 例:
"image"
使用量と課金情報
Show child attributes
Show child attributes