結論から: エンドポイントは、タスクと、ライブのカタログが各エンドポイントに付けているコンテンツラベルで絞り込み、次に自分のブリーフをそれぞれ数回試して、完了したタスクの数ではなく使える結果の数を数えてください。「弱められた」とラベルされたエンドポイントは、トーンダウンした画像で成功かつ課金済みのタスクを返すので、ステータスが緑でも何の証明にもなりません。また SpicyAPI はリクエストも結果もスキャンしません。製品が法律と自社ルール内に収まるよう確認する仕組みは、自分で組み立てる必要があります。以下のラベルと価格は 2026 年 10 月上旬時点のものです。基準となるのは、ライブの規制なし画像生成 API のカタログです。
コンテンツラベルが統合に意味すること
カタログの画像エンドポイントには、4 つのラベルのいずれかが付いています。カタログで稼働中の 59 個の画像エンドポイントのうち、40 個が規制なし、3 個が弱め、12 個がフィルター、4 個がラベルなし(背景削除、アップスケーリングなどのユーティリティ)となっています。
| ラベル | モデルの限界を超えるブリーフを API がどう扱うか | 自分で処理すべきこと |
|---|---|---|
| 規制なし | モデルはコンテンツフィルターを宣言せず、SpicyAPI はスキャンを追加せずにリクエストを転送します。 | 呼び出しの前後に行う自分自身の確認。 |
| 弱められた | タスクは成功して課金されますが、画像はトーンを抑えた状態で返ります。 | 出力を確認してください。ステータスコードでは分かりません。 |
| フィルター | モデルは拒否します。タスクは failed と errorCode: "content_rejected" で終わります。 | 中立的なメッセージを表示し、そのまま再試行しないでください。拒否は通常は課金されませんが、一部のモデルページでは課金されると記しています。ページを確認してください。 |
| ラベルなし | 測定していません。 | どちらとも決めつけないでください。 |
ラベルが属するのはファミリーではなくエンドポイントです。Wan 2.7 Pro ではテキストから画像が弱められている一方、編集用のエンドポイントは規制なしです。両方を混ぜたベンチマークは、2 つの異なる約束を比較していることになります。ラベルはまた、情報としてのみ働きます。何が期待されるかを示しますが、何が保証されるかではありません。
プラットフォーム側のスキャンがないため、コンテンツと利用ポリシーの無条件の規則は自社製品の責任になります。未成年者が関わる性的表現、記録された同意のない識別可能な実在人物の親密な描写(顔の入れ替えを含む)、なりすましはすべて禁止です。呼び出しの前に、年齢確認、実在人物の入力に対する同意記録、ユーザーがコンテンツを報告できる経路を置いてください。長い版は「Building on a less restrictive model」にあります(現在は英語のみ)。
タスクで絞り込み、次にラベルと価格で
最初のワークフローについて一文を書いてください。たとえば「ライセンス済みのファッション画像を編集し、背景だけを変える」などです。その文が必要なタスクを教えます。タスクは別々のカタログエントリで、フィールドも別々です。価格は各ページの最も低い「〜から」価格です。解像度、参照画像、オプションで最終金額は変わります。
| エンドポイント | タスク | ラベル | 〜から | ページの説明では何用か |
|---|---|---|---|---|
| Qwen Image 3.0 | テキストから画像、編集 | 規制なし | $0.03 | 1 枚から 3 枚までの参照画像の編集。すでに画角内にある文字の書き換えも含みます |
| Seedream 5.0 Pro | テキストから画像、編集 | 規制なし | $0.036 | 最大 10 枚の参照画像から 1 枚の画角を構成し、枚ごとに役割の名前をつけます |
| Z-Image Spicy | テキストから画像 | 規制なし | $0.0124 | 正確なピクセル寸法でのテキストから画像。プロンプト拡張は有効にしない限りオフ |
| Prefect Pony XL | テキストから画像 | 規制なし | $0.015 | タグ形式のプロンプトからのアニメとイラストのスチル |
| Wan 2.7 Pro | テキストから画像、編集 | 弱められた(テキストから画像) | $0.075 | 大きなキャンバスの 1 枚。デフォルトは 2k、最大 4k。フィルタリングはエンドポイントごとに異なります |
| Krea 2 Medium | テキストから画像 | 弱められた | $0.03 | 長いプロンプトから、一般的な 5 つの比率で 1 枚。デフォルトは PNG。結果が外れたときに再調整するための seed がない |
| Nano Banana 2 | テキストから画像、編集 | フィルター | $0.036 | 最大 14 枚の参照画像での編集。0.5K から 4K |
これはランキングではなく候補リストです。成人向けの製品なら、タスクに合う規制なしの行から始めてください。弱められた行が効くのは、ブリーフがその限界のはるかに内側にある場合だけです。フィルターされた行は、混合製品の全年齢向けの半分に向きます。Prefect Pony XL はカンマ区切りのタグと 7 つの固定サイズを期待するため、フォトリアル系モデルのために書いた文のブリーフではなく、タグ形式のプロンプトを渡してください。
各モデルページはテストレポートへリンクしています。たとえば Z-Image Spicy と Seedream 5.0 Pro です。示唆的なシーンから強い成人シーンまで、実際の出力と中央値の時間(Z-Image Spicy で約 18 s、Seedream 5.0 Pro で約 70 s)が載っています。まずそれらを読み、その後、自分のサーバーからタスク作成からダウンロード可能な結果までの待ち時間を測定してください。
礼儀のよい代替ではなく、自分のブリーフを試す
自社製品が実際に提供する強さでブリーフを書いてください。架空の成人キャラクターか、使用を許可された入力で。全年齢向け(SFW)の代替のセットは、弱められたエンドポイントを通してしまうことがあります。弱めは、ブリーフがモデルの限界を超えたときに初めて現れるからです。ブリーフはチケットや公開文書ではなく、非公開のテストリポジトリに保管してください。各フィクスチャを 3 回実行します。不安定さを露呈するには十分で、変更後に繰り返すには十分安価です。
| ID | フィクスチャ | わかること |
|---|---|---|
| 01 | 最も頻出するブリーフを通常の強さで | 基準となる有用結果の比率 |
| 02 | 同じブリーフを、許可する最強の強さで | エンドポイントが許容範囲の上端で、拒否・弱め・納品のどれをするか |
| 03 | フィクスチャ 01 の無害な 3 つの言い換え | 表現の変更が結果を覆すか |
| 04 | 許可された元画像と、名前を付けた 1 つの編集(背景、服の色、照明) | 編集が反映され、保護された部分が保たれるか |
| 05 | 同じ編集に 2 枚の参照画像を加え、それぞれに役割の名前をつけます | 追加の参照が助けになるのか、結果をぼかすのか、そして価格に何を足すのか |
| 06 | 公開する画角の形(たとえば 9:16) | 実サイズで構図が保たれるか |
| 07 | 自社アプリが止めなければならないブリーフ | 事前確認がブロックし、タスクが作られないこと |
| 08 | 送信した直後に切断されたリクエスト | クライアントが既存のタスクを回復し、二重に支払わないこと |
実行の前に、書面での合格ルールを決めてください。主題と構図がブリーフと一致すること。編集の保護領域が変わっていないこと。強度が指示より弱っていないこと。顧客が気づくほどのアナトミーや文字の不整合がないこと。候補ごとに 2 つの数値を記録します。有用結果の比率(合格した出力を完了したタスクで割ったもの)と、有用結果 1 件あたりのコスト(総支出を同じ数で割ったもの)です。これにより安価でも弱められたエンドポイントを、高価でも信頼できるエンドポイントと比較できます。より詳細な評価基準には画像 API ベンチマークガイドを使ってください。
まず Playground で 1 つのフィクスチャを試す
- 候補リストのエンドポイントのページを開きます。たとえば Z-Image Spicy テキストから画像 で、入金済みのアカウントにログインします。フォームはページにあります。
- フィクスチャ 01 を Prompt に貼り付け、画角のサイズを設定します(ここでは Width と Height。他のエンドポイントではアスペクト比またはサイズの項目を使います)。
- フォームの下の価格を読み、Run を押し、さらに 2 回実行してばらつきを見ます。
- フィクスチャ 02 と 03 も同じ手順で実行し、コードを 1 行も書く前に、それぞれの結果を合格ルールで判断します。

フィルムフレームがプロジェクターを通って 1 枚の完成画像になる。
同じテストをスクリプト化する
フィクスチャが Playground で期待どおりに動いたら、ファイルから実行します。見積は無料です。送信するときの本文をそのまま検証し、何も作らず、資金も保持しません。
spicyapi tasks quote --model alibaba/z-image-spicy/text-to-image --input-file fixture-01.json同じファイルから tasks create でタスクを作ります。再試行、ポーリング、結果はタスクのドキュメントと CLI のドキュメントにあります。
Agent に実行させることもできます。MCP サーバーならアシスタントは spicyapi_task_quote で見積を取り、npx skills add spicyapi-ai/spicy-skill は各呼び出しの前にライブのスキーマを読ませる Agent Skillをインストールします。
テストハーネスの組み方を変える事実が 5 つあります。
- 見積は最も安いテストです。 有料の実行の前に、すべてのフィクスチャを見積に通してください。ラベルは変わることがあるので、CI で各エンドポイントのラベルを再確認します。
- 各エンドポイントは自分の項目名だけを受け付け、未知の項目は拒否されます。 出力サイズだけでも書き方が 3 通りあります。Z-Image は
aspect_ratio、Prefect Pony XL は 1 つのsize、Z-Image Spicy はwidthとheightを使います。共通のリクエストではなく、ライブのスキーマからエンドポイントごとのアダプターを作ってください。 - 参照画像は価格上昇の原因になり得ます。 2 枚目以降の各枚は Seedream 5.0 Pro の見積に加算されるので、実際の枚数で本文をそのまま見積ってください。
succeededは使える、という意味ではありません。 モデルが何かを返しただけです。弱められた画像は、合格ルールで見つけます。拒否は通常は課金されません。- タイムアウトした create は実在する可能性があります。 二重に支払うのではなく、同じ Idempotency-Key で再送してください。それがフィクスチャ 08 です。
ダウンロードリンクと生成ファイルには期限があります。承認した画像は、タスクの参照を隣に置いて自分のストレージへコピーしてください(メディア保持の記事)。ポーリングと webhook の比較は「Polling versus webhooks」ガイドを参照してください(現在は英語のみ)。
選択の進め方
初めてのワークフローで必要なタスクを公開していないエンドポイントは外します。フィクスチャ 07 と 08 に落ちるものも外します。残りは同じブリーフで、有用結果の比率と有用結果 1 件あたりのコストで比べます。許容する強度範囲で最良の比率を持つ規制なしエンドポイントを優先してください。弱められたエンドポイントとフィルターされたエンドポイントは、その限界がブリーフに合う場所でのみ残し、「何でもできる」と約束するのではなく、自社のコピーにそう書いてください。フォールバックも同じフィクスチャを通さなければなりません。
よくある質問
規制なしのエンドポイントなら、自分の API にとって自動的に良い選択になりますか。
いいえ。フィルターが宣言されていない、という意味です。ブリーフに従うとか、使える画像 1 件あたりのコストが安いとかではありません。
弱められたエンドポイントが画像を抑えたかどうかを知るには。
フィクスチャ 02 と 01 を比較してください。弱められたエンドポイントは主題は残しますが、指示した強度を失います。タスクの応答にはそれを指摘するものがありません。
拒否には費用がかかりますか。
通常はかかりません。失敗したタスクは保留額を全額解放します。一部のモデルページは特定の拒否も課金されると記しているため、無料だと決めつける前にタスクの費用を確認してください。
顧客の本物の写真でテストできますか。
最初はできません。許可された入力または合成入力を使ってください。実在人物が含まれる入力には、その特定の編集と配布についての記録された同意が必要で、未成年者が関わるものは一切許可されません。
完了したタスクは、画像をユーザーに見せることができますか。
いいえ。完了したタスクは、モデルが何かを返しただけです。合格ルールで確認してください。弱められた結果もそこで捕まります。配信の前に、承認した画像を自分のストレージへコピーします。
確認はどのくらいの頻度で繰り返すべきですか。
ローンチの前と、モデル、ラベル、価格、スキーマが変更された後に。












