機能一覧
PixAI API でできること:アニメモデルと LoRA による画像生成、参照画像、インペイントとアウトペイント、画像から動画、参照動画、タスク・クレジット・制限の仕組み。
PixAI API は pixai.art と同じアニメモデルとコミュニティの LoRA で動作します。pixai.art のユーザーが生成できるものを、あなたのアプリケーションからも生成できます。このページでは、API でできること、その仕組み、まだ対応していない機能を、各機能のリファレンスへのリンクとあわせて紹介します。
生成できるもの
| 機能 | エンドポイント | 内容 |
|---|---|---|
| テキストから画像 | POST /v2/image/create | PixAI のモデルで、プロンプトから画像を 1 枚または 4 枚生成します。LoRA、スタイルプリセット、カラーパレットも使えます。 |
| 参照画像 | POST /v2/image/create の contextImages | 最大 3 枚の画像を参照します。キャラクターを一貫させたり、別の画像からポーズを取り入れたりできます。 |
| インペイント・アウトペイント・リドロー | POST /v2/gen-task/inpaint | マスクした部分を描き直す、画像を外側に広げる、画像全体を描き直す、のいずれかを行います。 |
| 画像から動画 | POST /v2/frame-video/create | Tsubaki 動画モデルで画像を 5〜15 秒の動画にします。2 枚目の画像で終わらせたり、音声を付けたりできます。 |
| 参照動画 | POST /v2/reference-video/create | 参照画像をもとに動画を生成します。モデルによっては参照動画や音声も使えます。 |
| モデルと LoRA | GET /v2/generation-model/search | PixAI モデルマーケットから、生成に使うベースモデルや LoRA を検索します。 |
画像
- モデル: Tsubaki.3、Tsubaki.2、Haruka v2、Hoshino v2 などの PixAI 独自のモデルと、モデルマーケットのほかのベースモデルを使えます。モデルをご参照ください。
- サイズ:
1:3から3:1までの 11 種類のアスペクト比と、2 つの解像度(1kと1.5k)から選べます。Tsubaki.3 の大きな出力などほかのサイズは、モデルのサイズ範囲内でwidthとheightを指定します。対応解像度をご参照ください。 - 品質と速度:
modeで推論プロファイル(lite、standard、pro、ultra)を選びます。モデルやプランによっては使えないモードがあります。 - LoRA: メンバーシップなしで最大 3 個、メンバーシップがあれば最大 15 個の LoRA を、それぞれの重みで適用できます。LoRA は生成に使うモデルと同じベースモデル向けのものを選んでください。
- プロンプト: Tsubaki.2 と Tsubaki.3 では最大 10,000 文字(ほかのモデルでは 4,096 文字)のプロンプト、ネガティブプロンプト、同じ結果を再現するための
seed、短いプロンプトを補うプロンプトヘルパーを使えます。 - スタイルと色: 名前付きの
styleプリセットと、Tsubaki.3 のカラーパレットを使えます。
画像の編集
- インペイント: マスクの白い部分を描き直します。
- アウトペイント: 画像を大きなキャンバスに置き、広げた部分を描き足します。
- リドロー: マスクなしで画像全体を描き直します。
strengthで元の画像からどれだけ離れてよいかを決めます。
マスクの形式はインペイントとアウトペイントの使用例をご参照ください。
動画
| エンドポイント | モデル | 参照 | 長さ |
|---|---|---|---|
| 画像から動画 | Tsubaki(tbkv1.0.1、tbkv1.0) | 最初のフレーム、任意で最後のフレーム | 5〜15 秒 |
| 参照動画 | Tsubaki | 画像 1〜6 枚、音声 3 個まで | 5〜15 秒 |
| 参照動画 | Seedance 2、Seedance 2 Fast | 画像 9 枚、動画 3 本、音声 3 個まで | 4〜15 秒 |
| 参照動画 | Seedance 2.5 | 画像 30 枚、動画 10 本、音声 10 個まで | 4〜30 秒 |
| 参照動画 | Vidu | 画像 1〜7 枚 | 3〜16 秒 |
どちらの動画エンドポイントも音声を生成できます。音声のセリフは英語・日本語・韓国語・中国語、またはセリフなしを選べます。professional モードでは、対応するモデルでアップスケールが加わります。画像から動画には PixAI メンバーシップが必要です。
仕組み
- HTTPS の REST API です。
https://api.pixai.artに、API キーをAuthorization: Bearer <key>として送って認証します。PixAI APIを使用するには?をご参照ください。 - 非同期タスク: 生成エンドポイントはすべてタスクを返します。
completed、failed、cancelledのいずれかになるまでGET /v2/task/{id}をポーリングするか、Webhook で状態の更新を受け取ります。 - メディア ID: 入力も出力もメディア ID で扱います。画像や音声はアップロード用のエンドポイントでアップロードするか、生成した画像を再利用します。
GET /v2/media/batchでメディア ID をダウンロード URL に変換します。 - 結果はダウンロードして保存: 生成されたメディアはいつまでも保存されるわけではありません。タスクが完了したら、必要なファイルを早めに保存してください。
- 非公開: API で生成した画像は、pixai.art の公開生成履歴に表示されません。
- 機械可読なドキュメント: OpenAPI 仕様、llms.txt、全ページの Markdown 版、コーディングエージェント向けのドキュメント MCP サーバーがあります。
一連の流れを試すには、最初のAPIリクエストをご覧ください。
クレジットの消費
API は、API キーを持つ PixAI アカウントのクレジットを消費します。
- タイミング: クレジットはタスクの作成時に消費されます。失敗したタスクのクレジットは返還されます。
- 消費量: リクエストの内容によって変わります。
- 画像:モデル、出力サイズ、
mode、生成枚数。 - インペイント・アウトペイント・リドロー:画像のサイズと
strength。 - 動画:モデル、長さ、
professionalモード、音声を生成するかどうか。
- 画像:モデル、出力サイズ、
- 確認方法: 各タスクの
paidQuotaに、そのタスクで消費したクレジットが表示されます。大量に実行する前に、一度リクエストを送って消費量を確認してください。
画像から動画、4 個以上の LoRA、一部のサイズやモードなど、PixAI メンバーシップが必要な機能があります。プランに含まれない機能をリクエストすると、エラーで拒否されます。
制限
- 1 アカウントにつき、キューで待機できるタスクは同時に 10 件までです。実行中のタスクは数に含まれず、上限はアカウントごとに引き上げ可能です。
- タスクのポーリングは 1.5 秒に 1 回までにし、再試行時は間隔を空けてください。
詳しくは制限事項をご参照ください。
API で未対応の機能
PixAI Reference Pro、PixAI Edit、PixAI Edit Lite は pixai.art で使えますが、API ではまだ使えません。これらの機能は現在開発中です。
権利と商用利用
API で生成した画像の著作権はユーザーに帰属し、PixAI は権利を主張しません。承認されたユーザーは、Tsubaki や Haruka などの PixAI 公式モデルを商用利用できますが、モデルファイル自体の転売や再配布はできません。生成したコンテンツは第三者の権利を侵害しないようにしてください。著作権および関連する権利をご参照ください。
次のステップ
- クイックスタート:API キーを取得して、最初のリクエストを送ります。
- 使用例:画像から動画、キャラクターの一貫性、インペイント、LoRA の完全なスクリプト。
- API v2 リファレンス:すべてのエンドポイントのすべてのパラメーター。