PixAI API で躓いたポイント
PixAI は、AIを用いた数多くある画像生成サービスのうちの一つです。
特徴として ControlNet の指定が可能、 LoRA の指定や生成が可能、API 経由での生成が可能、ということが挙げられます。
この最後の一つ、API を実際に試した際にいくつか不明点があり、先日サポートへ問い合わせて回答を貰ったので、内容をまとめておきます。
※原文そのままではありません。
公式ドキュメント：https://platform.pixai.art/docs
※本記事は 2025年11月時点の挙動をもとにしています。
最新仕様は公式ドキュメントの確認を推奨します。
1. "mediaId"ないし"mediaUrl"を取得するにはどうすればよいのか？
API パラメータに 参考画像 を指定したい場合、
ブラウザで生成画像を右クリック →「アドレスをコピー」すると取得できるURLを使う。
※以前は mediaId というパラメータが存在したが、現在はドキュメントから削除済み
2. PixAI 以外で用意した画像は使えるのか？
使用可能。ただし、URLは認証なしでアクセス可能（公開 URL）であること。
3. ControlNet（特に OpenPose）は画像を投げるだけで使えるのか？
現時点ではAPIでの ControlNet 利用は非推奨。
ちなみにドキュメントは最近アップデートしたらしく、後日、改めて確認したらパラメータから、mediaIdとcontrolNetが削除されてました。無駄に悪戦苦闘して時間を無駄にしてしまいました。公式ドキュメントの情報が古いとか不正確というのはよくある話ですが、変化の激しいAI関連サービスは特にそうなのかも。
まとめ（2025年11月時点）
- 参考画像 URL は生成画像の直リンクで取得する。mediaId は廃止
- 外部画像の利用は可能だが、公開アクセスできる URL が必須
- API 経由の ControlNet は非推奨