メインコンテンツへスキップ
見出し画像

Muse×PixAI APIの使い方!スマホから、AIにAIを使わせてみた

    • 本記事はPixAIとのタイアップ(PR)です。 手順・作例・感想は、すべて筆者が実際に試して記録したものです。機能や仕様は変動するので、利用前に各公式で最新を確認してください。

    先日、寝転がりながらスマホで、Metaのパーソナルエージェント「Muse」——うちでは“モコ”と呼んでいる——に「PixAIで絵を描いて」と頼んだら、数十秒で1枚返ってきた。コードは一行も書いていないし、PixAIの画面すら開いていない。AIに別のAIを使わせる、という作業が手元でできてしまう。やったのは「合言葉を入れる」「文章で頼む」「できたものを確認する」の3つだけだ。今回は、その3ステップを画面つきでたどる。ゴールは“つないで、1枚出して、数枚まとめて作る”までとする。LoRA学習や漫画制作のような応用は、別記事にゆずる。

    (検証日:2026年11月13日。作例は自作のオリキャラ「ソラ」。版権キャラ・実在人物は使っていない。)

    AIに頼む → 別のAIを使用して返ってくる、の全体像

    画像
    Museのチャット画面と、生成された1枚目のソラを並べたもの

    左が指示したチャットで、右が出てきた絵だ。ハニーブロンドのロング、青い瞳、右サイドの忘れな草、白いアンドロイドメイド——指定した要素がそのまま乗っている。今回はオリキャラ「ソラ」の確定ビジュアルには寄せていないが、プロンプトの内容どおりに出ているのが分かる。これを、設定はそのままで、表情や構図だけを変えながら数枚まとめて回せるようにしていく。

    登場人物は2人。モコ(Muse)とPixAI

    ここだけ押さえれば迷わない。今回やるのは、MetaのAIエージェント「Muse」に、PixAIのアカウントを操作させるという構図だ。

    画像
    Muse(モコ)が段取りしてPixAIが描く、という役割分担
    • Muse は、Metaが提供するパーソナルエージェント。2026年10月に日本でも使えるようになった。クラウド側に“自分専用のPC”を持っていて、ファイルの作成もコードの実行も代わりにこなす。だから手元はスマホのブラウザで足りる。基本機能は無料で、さらに使いたい人向けの有料プランもある(Meta公式)。アクセスは muse.ai、またはMuseアプリ(iOS/Android)からだ。

    • PixAI は、実際に絵を描く画像生成エンジンのほうだ。Tsubaki.3のようなモデルを備えている。

    つまり役割分担としては、モコが段取りして動かし、PixAIが描く。この二役が別物だと分かっていれば、次でいちばん大事な一点を間違えずに済む。

    “Web操作”より“API”が向く理由

    AIにPixAIを使わせる道は2つある。ひとつは、サイトを人間のようにポチポチ操作させる方法だ。手軽ではあるが、画面のデザインが変わると止まりやすく、動きも遅い。もうひとつが、今回使うAPIだ。
    APIとは、サイトの画面を通さずに裏側で直接やりとりする通り道のことを指す。画面のボタンに触らないのでUIの変更に強く、設定を数値で固定できる。同じ設定でまとめて作りたいなら、こちらが向いている。

    準備:PixAI側で2つ用意する

    ① APIキー=PixAIの「合言葉」

    APIキーは、「このPixAIアカウントの持ち主だよ」と証明する合言葉だ。これがないと外からの生成依頼を受け付けてもらえない。迷いやすいのは「合言葉はモコとPixAIのどちらで作るか」だが、答えはPixAI側。モコは“PixAIを使う人”なので、PixAIの合言葉を渡して代わりに使ってもらう関係だからだ。

    取り方はPixAIのAPIドキュメントで確認した。会員はその場で即発行、非会員はメール申請で最大5営業日かかる。私は会員なので、右上アイコン →「設定」→「APIプラットフォーム」→「APIキーを作成」で発行できた。

    画像
    「設定」→「APIプラットフォーム」
    画像
    「APIキーを作成」
    画像

    注意は一点。キーは作成時に一度しか表示されない(発行後はサービス側で保管されず、保存は持ち主の責任になる仕組みだ)。sk- で始まる文字列が出たら、閉じる前にコピーしておく。
    逃しても作り直せるので、慌てなくていい。

    ② モデルのバージョンID(モデルIDとは別物)

    もうひとつ用意するのが、どのモデルで描くかを指す番号=バージョンIDだ。モデルページで使いたいバージョン(「v1」など)を選ぶと、URLの末尾にバージョンIDが付くので、それをコピーする。

    注意は、バージョンを選ぶ前のURLに出ている番号はモデルIDで、別物だということ。Tsubaki.3なら、素のURL末尾は 2024383378759147749(モデルID)。v1を選ぶと …/2024383378759147749/2024383379556065549 のように後ろへ番号が付き、この 2024383379556065549 がバージョンID=APIに渡す値になる。

    画像
    Tsubaki.3でv1を選んだときのURL

    なお、キーを使う前に、PixAIのWeb版で何枚か生成し、使うモデルとプロンプトを先に決めておくといい。APIは設定を固定して忠実に回す=間違った設定もそのまま量産してしまう。
    手探りの工程をWeb版で先に済ませると、クレジットを無駄にしない。

    モコに設定させる(送る文章は全部コピペでOK)

    muse.aiを開くと、もうあなたのエージェントとのチャットが始まっているはずだ。上から順に頼んでいこう。

    手順1:入れ物を作る

    ワークスペースに pixai-batch フォルダを作って、その中に Sample.env.txt を置いて。中身は PIXAI_API_KEY= の1行だけにして。値はまだ空でいい。
    画像

    手順2:合言葉を“ファイルに”入れる

    画像

    できたファイルはまだ空だ。「ライブラリ」→「システムファイル」から Sample.env.txt を開き、PIXAI_API_KEY= の後ろにキーを貼って保存する。チャット欄には打たない。履歴に合言葉を残さないためだ。

    手順3:ファイル名を整える

    Sample.env.txt を .env にリネームして。

    リネーム後、表示から消えて見えることがあるが、存在はしている。不安なら「.env は読める?」と聞けば確認してくれる。

    手順4:プロンプトの一覧を作る

    pixai-batch の中に prompts.csv を作って。1行=1プロンプトで、まずは1行だけ。カンマを含むプロンプトはダブルクォートで囲んで。1行目はこれ:
    "ハニーブロンドのロングヘア、澄んだ青い瞳、右サイドに忘れな草の髪飾りの少女ソラ。白を基調としたアンドロイドメイドの衣装。上半身、無地背景、やわらかい光、高精細アニメイラスト。"
    画像

    Tsubaki.3は、タグを羅列するより、日本語の文章で位置と形を書くほうがよく通る。書き方は公式のTsubaki.3プロンプトガイドにくわしい。

    まず1枚、それから数枚

    まずは1枚だけ試す

    生成を頼む小さなプログラム(スクリプト)は、モコに書かせる。次の文章を送ろう。少し長いが、意味が分からなくても、そのまま貼れば動く。

    送る文章(テンプレ):
    pixai-batch フォルダに、PixAI API で画像を一括生成する Python スクリプトを作ってください。
    ・APIキーは .env の PIXAI_API_KEY から読み込む。画面には表示しない。
    ・生成リクエストは POST https://api.pixai.art/v2/image/create に送る。
     ヘッダーは Authorization: Bearer <キー> と Content-Type: application/json。
     タイムアウトは120秒。成功コードは 201(200も成功として扱う)。
    ・パラメータ(固定):modelVersionId = 2024383379556065549(Tsubaki.3)、
     aspectRatio = 2:3、batchSize = 1、negativePrompt は空。loras は入れない。
    ・prompts.csv を1行ずつ読み、1行につき1タスクを作る。
    ・作成したら、すぐ「行番号・タスクID」を tasks.log に書く。
    ・進捗確認は GET https://api.pixai.art/v1/task/{taskId} を3秒間隔で見る。
    ・完成画像は output/ フォルダに「行番号_連番」で保存する。
    ・送信がタイムアウトしたら自動で再送しない。その行は failed_tasks.log に記録して私に知らせる。
    ・--task-id を指定したら途中から再開できるようにする。
    ・まず prompts.csv の件数を私に見せて、確認がとれてから生成する。最初は1行目だけ(1枚だけ)。

    送ると、モコはいきなり生成しない。件数と設定を先に見せて、いったん止まる。そこで「OK、1枚だけ生成して」と返す。

    画像

    数十秒で、1枚目が出た。

    画像

    書いた要素が全部乗っている。ここまでの動作で、実測してみると…

    • 消費:約4,000クレジット(生成前後の残高差・実画面の数値)
    • 時間:約80秒/枚
    • 動いた場所:モコのクラウド側で完結(手元のiPhoneは何もしていない)

    補足すると、公式の料金ガイドは生成費用を「1枚あたりいくらの固定ではなく、設定で変わる」と明記している(PixAI料金プラン完全ガイド)。この約4,000も“この設定(Tsubaki.3・2:3)での実測値”にすぎない。まず1枚試して、自分の消費を知っておくのがいい。

    次は数枚まとめて作る

    感触をつかんだら、prompts.csvに行を足してもう一度回してみる。

    送る文章(テンプレ):
    prompts.csv に次の3行を追加して、全部で4行にして。各行はダブルクォートで囲んで。
    2行目:"ハニーブロンドのロングヘア、澄んだ青い瞳、右サイドに忘れな草の髪飾りの少女ソラ。白いアンドロイドメイドの衣装。やわらかく微笑む表情、斜め上からの構図、上半身、無地背景、高精細アニメイラスト。"
    3行目:"ハニーブロンドのロングヘア、澄んだ青い瞳、右サイドに忘れな草の髪飾りの少女ソラ。白いアンドロイドメイドの衣装。正面、きりっとした真顔、上半身、無地背景、高精細アニメイラスト。"
    4行目:"ハニーブロンドのロングヘア、澄んだ青い瞳、右サイドに忘れな草の髪飾りの少女ソラ。白いアンドロイドメイドの衣装。窓辺で朝の光を浴びる、やや横顔、上半身、高精細アニメイラスト。"
    追加したら件数を見せて。確認したら、2〜4行目を順番に各1枚ずつ生成して(1行目はもう出たのでスキップ)。
    画像

    声かけ1回で、どんどん生成を回してくれる。
    消費は3枚で約12,000(1枚約4,000で一致)。

    画像

    同じソラが、表情と構図だけ変わって並ぶ。ここがAPIの本番だ。Web版なら、貼る→生成→保存を1枚ずつ10回くり返すことになるが、APIは行を足して「回して」と一声かけるだけで、output/ に溜まっていく。手で10回ぶんの作業が、声かけ1回に置き換わる。

    途中、保存形式が少しズレたのを、モコが自分で気づいて直していた。私は何もしていない。気づいた所だけ直してまた回せる=試行を気軽に重ねられるのが、地味に効く。

    つまずきと、よくある質問

    ・キーが読み込まれない
    ファイル名が .env か、PIXAI_API_KEY= の後ろに正しく貼れているかを確認する。モコに「.env は読める?」で済む。

    ・送信がタイムアウト
    再送しないのが正解だ。画面に「返事が来ない」と映っても、注文はPixAI側に届いていることがある。再送すると二重発注になり、クレジットも二重に減る。失敗した行だけ入れ直す。

    ・思ったのと違う絵が並ぶ
    先にWeb版で当たりを取る。少数で試してから増やすのがよい。

    Q. コードが書けなくても使える?
    使える。コードを書くのはモコの担当なので、こちらがやるのは「合言葉を入れる・頼む・確認する」だけでいい。私もスマホのブラウザだけで行った。

    Q. APIで作った画像は公開される?
    非公開だ。公式ドキュメントによると、API経由の生成は公開履歴に表示されない。ただし長期保存はされないので、残すなら保存を(今回のスクリプトは自動で output/ に保存している)。

    Q. APIだけで全機能使える?
    いまはテキストからの生成や部分的な描き直しが中心で、Reference ProやEdit Proのような画像編集はAPIに未対応だ(そこはWeb版の担当)。使える機能は増えていくので、利用時に公式ドキュメントで確認しておきたい。

    Q. お金をかけずに試せる?
    非会員でも1日10,000クレジットの無料枠がある(公式)。今回の設定なら1枚約4,000なので、無料枠でも1日に2枚ちょっと。数を回すなら会員のクレジットが現実的だ。

    最後に:まず手で、それから任せる

    やってみて思ったのは、APIは「手でわかったことを速くする道具」だということだ。逆に、手でわかっていない工程は、自動化しても迷子になる。

    だから、効率のいい順番はこうなる。まずPixAIのWeb版で「このモデル×このプロンプト」を手で見つける。決まったら合言葉(APIキー)を用意する(取り方はAPIドキュメント)。あとは、この記事の手順をなぞるだけでいい。気づけば、“別世界”だと思っていたものが、声をかければ動く相棒に変わっている。

    一括生成の先、LoRA学習や漫画制作まで踏み込みたくなったら、応用編のMuse×PixAI APIの使い方(応用編)が次の地図になる。まずは1枚から、始めてみてほしい。

    この記事について
    ・本記事はPixAIとのタイアップ(PR)です。
    ・筆者:東風(こち)。検証日2026年11月13日。作例は自作のオリキャラ「ソラ」(版権・実在人物は不使用)。生成はMuse(Meta)経由でPixAI APIを呼び出し、iPhoneのブラウザから実施(端末へのインストールなし)。
    ・使用環境:Tsubaki.3(modelVersionId 2024383379556065549)/2:3/batchSize 1/LoRA不使用。消費クレジットは実画面の残高差による実測値(1枚約4,000・この設定での値)、所要約80秒/枚。キャプチャはAPIキー・アカウント情報をマスク。MuseはMetaのパーソナルAIエージェント(muse.ai・iOS/Android、基本無料+有料プラン)で、PixAI公式サービスではありません。
    ・参照(2026年11月確認):Meta公式「Muse」発表、PixAI APIドキュメント、PixAI公式ブログ「料金プラン完全ガイド」「Tsubaki.3プロンプトガイド」「Muse×PixAI API(応用編)」。仕様は変動するため、利用前に各公式で最新を確認してください。

     
     

    東風

     
     
    冗長な情緒を構造にする表現と可視化に興味があります。 お仕事のご依頼:cochi.kokonoe.404[at]gmail.com

    あなたへのおすすめ