curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "mj-v8.2",
"prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
"quality": "standard",
"model_params": {
"speed": "fast"
}
}
'
{
"created": 1757165031,
"id": "task-unified-1757165031-mjv82",
"model": "mj-v8.2",
"object": "image.generation.task",
"progress": 0,
"status": "processing",
"task_info": {
"estimated_time": 60
},
"type": "image",
"usage": {
"billing_rule": "per_call",
"credits_reserved": 5.4,
"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: mj-v8.2",
"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"
}
}Midjourney V8.2
Midjourney V8.2 画像生成
- Midjourney V8.2 モデルは自然言語プロンプトによる高品質な画像生成をサポートします。Fast モードは 1 回の生成で 4 枚の画像を返します。Draft モードは 1 回の実行で 24 枚の軽量な 512 px スケッチ画像を返します
- テキストから画像への生成と、画像から画像への生成(prompt 内で画像 URL を参照)をサポート
- 入力画像の URL は公開アクセス可能で、約 10 秒以内に取得できる必要があります。上流はタスク作成時に画像を取得し、取得できない場合はタスクが失敗し、予約されたクレジットは返金されます。中国本土以外の画像ホスティング(imgur、ibb、raw.githubusercontent、pinimg、picsum)は実際には失敗します。画像は高速な CDN にホストするか、プラットフォームのファイルアップロードを使用してください
- V8.2 のハイライト:V8.1 からの美的表現と画質の向上、精細度は prompt 内のネイティブパラメータ
--quality/--q(1-4、4 = 高品質モード)で設定(追加料金なし)、ネイティブ 2K 出力(quality=hd)。V8.2 では turbo は利用できません(上流のドキュメントでは V8 は turbo 非対応とされています) - スタイル参照(
--sref)をサポート。--oref/--crefは V8.2 ではサポートされず、上流で拒否されます。プロンプトパラメータガイドを参照 - 上流がサポートしないプロンプトパラメータはそのまま透過されます:タスクはパラメータエラー(
invalid_parameters)で失敗し、予約されたクレジットは返金されます(黙って破棄されることはなくなりました) - 非同期処理モード。返されたタスク ID を使用してステータスを照会
- 生成された画像リンクの有効期限は 30 日です。お早めに保存してください
- タイムアウト:約 20 分
- パラメータの注意:本インターフェースは V8.2 に固定されており、niji はサポートしていません。速度モードは
model_params.speed、出力品質はトップレベルのqualityパラメータで設定してください。精細度は prompt に--quality/--q(1-4)として記述し、そのまま透過されます mj-v8.2-edit/mj-v8.2-upload-paintはキャンバス編集(img_pos + mask)です。上流の指示ベース編集エンドポイント(--edit、最大 4 枚の参照画像)は本ルートではまだ公開されておらず、提供時期を調整中です
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": "mj-v8.2",
"prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
"quality": "standard",
"model_params": {
"speed": "fast"
}
}
'
{
"created": 1757165031,
"id": "task-unified-1757165031-mjv82",
"model": "mj-v8.2",
"object": "image.generation.task",
"progress": 0,
"status": "processing",
"task_info": {
"estimated_time": 60
},
"type": "image",
"usage": {
"billing_rule": "per_call",
"credits_reserved": 5.4,
"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: mj-v8.2",
"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"
}
}Midjourney にはコンテンツ審査機能が組み込まれています。審査は画像ごとに行われ、フィルタリングされた画像は結果に含まれず、残りの画像は通常どおり返されるため、受け取る画像の枚数が通常より少なくなる場合があります。1 枚でも審査を通過すればタスクは
completed となり、通常どおり課金されます。すべての画像がフィルタリングされた場合、タスクは failed となり、予約されたクレジットは全額返金されます。プロンプトと参考画像がコンテンツガイドラインに準拠しているかご確認ください。承認
##全てのインターフェースはBearer Token認証が必要です##
API Keyの取得:
API Key管理ページにアクセスしてAPI Keyを取得してください
リクエストヘッダーに追加:
Authorization: Bearer YOUR_API_KEY
ボディ
application/json
プロンプト。Midjourney V8.2 のすべてのネイティブパラメータ構文をサポートします(例:--ar 16:9 --s 500)。
画像から画像: prompt の先頭に画像 URL を配置します。対応フォーマット:.png, .gif, .webp, .jpg, .jpeg
画像から画像のルール:
- 画像 1 枚 + テキストなし = 無効(エラーになります)
- 画像 1 枚 + テキスト説明 = 有効
- 画像 2 枚以上 + テキストなし = 有効
- 画像 2 枚以上 + テキスト説明 = 有効
サポートされないパラメータ: 上流がサポートしないパラメータ(例:--oref、--cref、--stop)はそのまま透過され、上流で明示的に拒否されます。タスクはパラメータエラー(invalid_parameters)で失敗し、予約されたクレジットは返金されます。--v / --version / --niji、--bs / --batchsize および速度 / hd のパラメータは除去され、API パラメータで制御されます。--quality / --q(1-4)はそのまま透過されます。
Maximum string length:
2048例:
"A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500"
タスク完了後のHTTPSコールバックアドレス
コールバックタイミング:
- タスクが完了(completed)または失敗(failed)したときにトリガー
- 課金確認完了後に送信
セキュリティ制限:
- 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秒後にリトライ) - コールバックレスポンスのフォーマットはタスク照会インターフェースの戻り値と同一
- コールバックアドレスが2xxステータスコードを返した場合は成功、その他のステータスコードはリトライをトリガー
例:
"https://your-domain.com/webhooks/image-task-completed"
レスポンス
タスク作成成功