creatok-generate-image

generate-image

制約

• モデルのユーザー向け最終応答は、ユーザーの入力言語に合わせます。デフォルトは英語です。
• 有料または高コストの画像生成を実行する前に、必ずユーザーの確認を求めます。
• 確認後、CreatOK Open Skills proxy を呼び出し、完了するまで待機します。
• ユーザーがデバッグの詳細を明示的に必要としている場合を除き、ユーザー向けの応答では技術的な表現を避けます。

モデル選択ルール

モデルの一覧、デフォルト値、ハードリミットはローカルにハードコードせず、実行時に CreatOK capabilities エンドポイントから取得する必要があります。

ローカルクライアントは薄いままにします。

• ユーザーが別の対応モデルを明示的に選択した場合を除き、返されたデフォルトモデルを使用します
• 解像度、アスペクト比、枚数、参照画像の上限など、実行に関するハード制約のみを検証します
• ユーザー向けのモデルの説明は最小限にとどめ、プロバイダー、ファミリー、ヒント形式のメタデータには依存しないようにします

確認が必要な入力（不足している場合に質問）

• 良い画像の生成に必要な情報だけを尋ねます
• 解像度またはアスペクト比が指定されていない場合は、capabilities エンドポイントから返されたモデルのデフォルト値を使用します
• プロンプトが曖昧な場合は、生成を確認する前に内容を調整するか尋ねます
• 参照画像は任意です。ユーザーがスタイルの転写や被写体の参照を意図している場合にのみ尋ねます
• 参照画像を使用する場合は、まずローカル画像ファイルをアップロードし、生成タスクには返されたアップロード済み参照画像を指定します

ワークフロー

1. 確認ゲート（必須）

• 以下を要約します。
  • モデル
  • 解像度
  • 画像の枚数（n）
  • 指定されている場合はアスペクト比
  • 利用可能な場合は推定コスト／クレジット数
• 送信前に、簡単な確認を求めます。
• ユーザーが「はい」と言うまで、生成タスクを送信しないでください。

2. 画像生成を送信

• CreatOK を呼び出します。POST /api/open/skills/image-generation

3. 完了までステータスをポーリング

• CreatOK を呼び出します。GET /api/open/skills/tasks/status?task_id=...&task_type=image_generation

4. 成果物を保存して応答

• 以下を書き込みます。
  • outputs/result.json に task_id/status/images/raw
  • outputs/result.md
• ユーザーが後から再開できるよう、送信直後に task_id を保存します。
• 最終的な画像 URL をそのまま返します。

既存タスクの復旧

• ユーザーがすでに task_id を持っている場合は、新しいタスクを開始せず、そのタスクを続行します。
• 復旧モードでは、タスク ID がすでにある場合、ユーザーにプロンプトを再入力させないでください。
• モデルはステータスを一度だけ確認するか、ユーザーが待機を希望する場合はポーリングを続けることができます。
• タスクが成功している場合は、最終的な画像 URL をそのまま返します。
• タスクがキュー待ちまたは実行中の場合は、その状況を明確に説明し、引き続き確認するか尋ねます。
• タスクが失敗した場合は、失敗の理由を説明し、次の対応を提案します。

成果物

すべての成果物は generate-image/.artifacts/<run_id>/... の下に保存します。

薄型クライアントの境界

• このスキルは生成ジョブを送信し、ステータスをポーリングして、固定形式の出力を保存します。
• 会話からすでに意図が明確な場合、モデルはユーザーにアイデアを言い直させないでください。