Auteo で画像を生成する
auteo CLI(npm i -g @auteo/cli、その後 auteo auth login)を使用します。コマンドが終了コード 3 で終了した場合は、まず auteo-account スキルに従ってサインインしてください。MCP ユーザーも末尾に記載されている auteo_* ツールを使用して同様の操作ができます。
1. モデルを選択する
auteo model list --type text_to_image --json # 編集時は --type image_to_image
auteo model get <model> --json # すべてのパラメータ、オプション、制約を表示
生成前に必ず model get を読んでください。アスペクト比と解像度の階層はモデルによって異なり、resolutionsByAspectRatio で各アスペクト比が許可する階層が示されます。
おおまかなガイド(実際のリストは変わる可能性がありますので確認してください):
| 用途 | おすすめの最初のモデル |
|---|---|
| 最高品質、画像内のテキスト | openai/gpt-image-2-6-sunburst, google/nano-banana-pro |
| 高速で安価なドラフト | google/nano-banana, alibaba/z-image |
| リファレンス画像を使った写真編集 | google/nano-banana-2, bytedance/seedream-5-5 |
| Plus / Ultra サブスクライバーは無料 | subscriberUnlimited: true のモデル(例: alibaba/z-image) |
2. パラメータを選択する
--aspect-ratioは必須です。ユーザーが指定したものを使用し、指定がない場合は、アバターやアイコンには1:1、バナーやサムネイルには16:9、ストーリーには9:16、ポートレートには3:4を推奨します。一部のモデルではautoも使用できます。--resolutionはモデルに階層(1K/2K/4K)がある場合に必須です。高い階層ほどコストがかかります。ドラフトでは1Kをデフォルトとし、印刷や大画面表示が必要な場合のみ高解像度にし、その場合はコストが増えることを伝えてください。--n(1–4)は複数のバリエーションを生成します。それぞれ課金されます。--image <パス|https-url>(繰り返し指定可能)は、編集やスタイル参照用の画像を追加します。ローカルファイルはアップロードされます。許可される数はmodel getのinputAssetIds.maxに記載されています。- プロンプトは英語で記述してください。ただし、ユーザーが画像内に別の言語のテキストを希望する場合はその限りではありません。
3. 料金を確認してから生成する
auteo generate cost google/nano-banana-2 --aspect-ratio 16:9 --resolution 2K --json
auteo generate create google/nano-banana-2 --prompt "an elephant on a tightrope, expressionist style" \
--aspect-ratio 16:9 --resolution 2K --out ./images --json
--out <ディレクトリ> を指定すると、結果を待ってファイルをダウンロードします。JSON には files と outputs[].url が含まれます。--out / --wait を指定しない場合、コマンドは即座に requestId を返します。後で auteo generate wait <requestId> --out ./images で取得できます。
ユーザーにファイルのパスと消費したクレジット(cost)を伝えてください。
エラー発生時
- 終了コード 4(クレジット不足): 処理を停止し、auteo-account スキルに従ってください(ユーザーに料金と残高を伝え、チャージへのリンクを提示してください)。設定を勝手に下げないでください。
- 終了コード 2(パラメータ無効):
auteo model get <モデル>を再度読み、アスペクト比と解像度の組み合わせを修正してください。 - 終了コード 5(モデレーション拒否): フラグされた内容を除いてプロンプトを書き直してください。同じプロンプトを再送しても失敗します。
- 終了コード 6(制限超過): 同時に進行中の生成または送信件数の上限に達しています。待ってからリトライしてください。
create中のタイムアウトまたはネットワークエラー: 盲目的に再送信しないでください。auteo generate list --type image --limit 5 --jsonを実行してください。リクエストが存在しない場合、--client-request-id <表示されたID>を付けてリトライすれば、二重課金を防げます。- 結果に
status: failedがある場合:errorMessageを報告してください。suggestedModelが設定されている場合は、それをユーザーに提案してください。
MCP ツール
auteo_list_models, auteo_get_model, auteo_estimate_cost, auteo_upload_image(inputAssetIds 用の assetId を返す)、auteo_generate_image, auteo_get_generation(pollAfterMs 後に再度呼び出し、done になるまで繰り返す)、auteo_list_generations。