Base URL: https://api.apimart.ai認証: Authorization: Bearer <token>新しい /v1/midjourney/... ルートは model=midjourney を自動注入するため、リクエスト本文に model を渡す必要はありません。
クイックスタート
# 1. Imagine タスクを送信
curl -X POST https://api.apimart.ai/v1/midjourney/generations \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"prompt": "a cute cat, watercolor style --ar 16:9"}'
# 2. 統一タスク API を status=completed までポーリング
curl https://api.apimart.ai/v1/tasks/task_01JWXXXX \
-H "Authorization: Bearer <token>"
# 3. 1 枚目をアップスケール
curl -X POST https://api.apimart.ai/v1/midjourney/generations/upscale \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"task_id": "task_01JWXXXX", "index": 1}'
エンドポイント一覧
各機能の完全なフィールド、例、注意事項は対応する子ページを参照してください。
| 機能 | パス | ドキュメント |
|---|
| テキストから画像(デフォルト) | POST /v1/midjourney/generations | Imagine |
| テキストから画像(明示エントリ) | POST /v1/midjourney/generations/imagine | Imagine |
| 複数画像ブレンド | POST /v1/midjourney/generations/blend | Blend |
| 画像からテキスト | POST /v1/midjourney/generations/describe | Describe |
| 画像編集 | POST /v1/midjourney/generations/edits | Edits |
| アップスケール | POST /v1/midjourney/generations/upscale | Upscale |
| バリエーション | POST /v1/midjourney/generations/variation | Variation |
| 強いバリエーション | POST /v1/midjourney/generations/high-variation | High Variation |
| 弱いバリエーション | POST /v1/midjourney/generations/low-variation | Low Variation |
| 再生成 | POST /v1/midjourney/generations/reroll | Reroll |
| ズームアウト | POST /v1/midjourney/generations/zoom | Zoom |
| パン | POST /v1/midjourney/generations/pan | Pan |
| インペイント | POST /v1/midjourney/generations/inpaint | Inpaint |
| モーダル(追加パラメータ) | POST /v1/midjourney/generations/modal | Modal |
| 画像から動画 | POST /v1/midjourney/generations/video | Video |
| リシェイプ(強 / 弱) | POST /v1/midjourney/generations/remix-strong · /remix-subtle | Remix |
| タスク取得 | GET /v1/tasks/{task_id} · /v1/midjourney/{task_id} | タスク取得 |
参考:ベストプラクティス(ポーリング / リトライ / トラブルシュート) · 完全ワークフロー例(エンドツーエンド curl + クライアントラッパー)
全体フロー
エラー処理
エラーレスポンス形式
{
"error": {
"type": "invalid_request_error",
"message": "prompt is required"
}
}
よくあるエラー
| HTTP | type | 説明 |
|---|
| 400 | invalid_request_error | パラメータ不正(必須欠落、形式不正など) |
| 401 | authentication_error | API Key が無効 |
| 402 | payment_required | 残高不足 |
| 404 | not_found | タスクが存在しない |
| 429 | rate_limit_error | レート制限 |
| 500 | internal_error | サーバ内部エラー |
タスク失敗
タスク失敗時、fail_reason に理由が入ります。よくある値:
Banned prompt detected — 禁止語句を含む
Task timeout — タイムアウト(30 分超)。自動全額返金済み
No available upstream — サービス一時的に利用不可。時間をおいて再試行
MJ 新ルートの統一モデル名は midjourney です。action、version、speed から課金 key を生成します。通常のマッチ順は次の通りです。
midjourney@<action>-<version>-<speed>
-> midjourney@<action>-<version>
-> midjourney@<action>-<speed>
-> midjourney@<action>
-> midjourney
| 操作 | 課金名 | 説明 |
|---|
| Imagine | midjourney@imagine[-version][-speed] | テキストから画像 / 参照画像生成 |
| Blend | midjourney@blend[-speed] | 複数画像ブレンド |
| Describe | midjourney@describe[-speed] | 画像からテキスト |
| Edits | midjourney@edits[-speed] | 画像編集 |
| Upscale | midjourney@upscale[-version][-speed] | アップスケール |
| Variation | midjourney@variation[-version][-speed] | バリエーション |
| High Variation | midjourney@high_variation[-version][-speed] | 強いバリエーション |
| Low Variation | midjourney@low_variation[-version][-speed] | 弱いバリエーション |
| Reroll | midjourney@reroll[-version][-speed] | 再生成 |
| Zoom | midjourney@zoom[-version][-speed] | ズームアウト / 拡張 |
| Pan | midjourney@pan[-version][-speed] | パン拡張 |
| Inpaint | midjourney@inpaint[-version][-speed] | インペイント入口 |
| Modal | midjourney@modal[-speed] | インペイント追加パラメータ |
| Video | midjourney@video / midjourney@video-720p | 画像から動画、実課金 × batch_size |
| Remix Strong | midjourney@remix_strong[-speed] | 強リシェイプ(v8 / v8.1 のみ) |
| Remix Subtle | midjourney@remix_subtle[-speed] | 弱リシェイプ(v8 / v8.1 のみ) |
説明:
speed=relax または speed 未指定の場合、speed サフィックスは追加されません。fast / turbo は対応するサフィックスを追加します。
- 主バージョンは
v8.1、v7、v6.1、v5.2、v5.1 に正規化されます。
niji=true + version=7/6 は niji7 / niji6 に正規化されます。
価格はコンソールのモデル価格ページを参照。失敗時は全額自動返金。