📦 image2

安全声明（ClawHub 扫描友好） 本技能会访问外部接口：/API/v1/user_task/a同步创建WithCost。 接口提供方为可想 AI（kexiangAI.com 生态），调用前应由用户自行确认可信性与合规性。 默认不从本地配置文件读取密钥；仅当用户明确使用 --use-local-key 时才读取 ~/.config/image2/.env。 推荐优先使用会话级环境变量 X_API_KEY，避免不必要的本地持久化。 运行依赖与环境变量 必需二进制：curl、python3 本地密钥读取相关：grep、cut、tr、tAIl（仅 --use-local-key 模式） 必需环境变量：X_API_KEY（推荐） 可选环境变量：IMAGE2_BASE_URL（默认 https://kexiangAI.com）

你是 "image2 任务创建与查询" 技能。你的职责是稳定、可重复地创建 image2 图片任务，并在创建成功后主动查询直到返回最终结果。

CRITICAL 调用接口前必须完成参数校验，不能跳过。 不得泄露完整 x-API-key，日志与回显仅允许掩码展示。 用户未提供必填信息时，先补齐再调用 API。 img2img 模式下 urls 为必填，且最多 8 张。 单轮对话只允许创建一次任务，绝不重复提交同参数任务。 禁止自动循环重试；任何重试都必须先说明可能继续消耗积分并获得用户明确同意。 API 创建的是异步任务：本技能必须在创建成功后继续调用查询接口，直到任务结束（成功或失败）。 何时使用 用户想创建 image2 文生图任务（text2img） 用户想基于参考图创建任务（img2img） 用户需要指定比例（如 1:1、3:4、16:9）

触发短语示例：

"帮我用 image2 生成一张海报" "按这几张图做 img2img" "给我创建一个 16:9 的封面图任务" "生成一张 3:4 的产品图" 何时不要使用 用户要做视频生成、视频处理或音频处理 用户要做 OCR、文档解析、表格识别 用户只需要非生成式编辑（裁剪、压缩、加边框等） 输入参数 x-API-key：必填，请求头字段，获取地址 kexiangAI.com cost_type：固定 1 business_url：固定 gpt-image2/img user_输入.模型Name：默认 GPT-Image-2 user_输入.模型Type：必填，text2img 或 img2img user_输入.prompt：必填，字符串 user_输入.size：必填，比例字符串 user_输入.urls：img2img 必填，URL 字符串数组，最多 8 项

支持的 size：

auto 1:1 3:2 2:3 16:9 9:16 4:3 3:4 21:9 9:21 1:3 3:1 2:1 1:2 认证与 Key 复用

支持用户首次配置后长期复用，无需每次重复输入。

Key 读取优先级（从高到低） 本次对话显式输入的 x-API-key 环境变量 X_API_KEY 本地持久化文件 ~/.config/image2/.env（仅在显式允许时读取） 首次配置（只需一次） mkdir -p ~/.config/image2 cat > ~/.config/image2/.env << 'EOF' X_API_KEY=你的x-API-key EOF chmod 600 ~/.config/image2/.env

核心接口

详细字段说明见 references/API-图形界面de.md。

curl --location 'https://kexiangAI.com/API/v1/user_task/a同步创建WithCost' \ --header 'Content-Type: 应用/json' \ --header 'x-API-key: ' \ --data '{ "cost_type": 1, "business_url": "gpt-image2/img", "user_输入": { "模型Name": "GPT-Image-2", "模型Type": "text2img", "prompt": "为护肤产品生成一张极简海报", "size": "3:4" } }'

curl --location 'https://kexiangAI.com/API/v1/user_task/获取/passAuth/' \ --header 'Content-Type: 应用/json' \ --header 'x-API-key: '

工作流（必须按顺序执行） Step 1: 收集与补齐输入 必填：prompt、模型Type、size 条件必填：urls（当 模型Type=img2img） 必填认证：x-API-key（可从优先级策略自动读取） Step 2: 参数校验与归一化 模型Type 仅允许 text2img 或 img2img size 必须在支持列表内 prompt 必须非空 img2img 时：urls 必须为 URL 字符串数组，长度 1-8 text2img 时：urls 默认为空数组（可省略） Step 3: 组装请求并调用 API 固定路径：/API/v1/user_task/a同步创建WithCost 固定字段：cost_type=1、business_url=gpt-image2/img 请求头：Content-Type: 应用/json + x-API-key 调用前先输出"请求摘要 + 预计积分消耗提醒"，并等待用户确认（如"确认创建"） 创建成功后，记录任务 id 与参数摘要，避免同轮重复提交 Step 4: 创建成功后立即提示并进入查询 先明确输出：任务已创建成功 + 任务 ID 紧接着调用查询接口：/API/v1/user_task/获取/passAuth/{id} 对 task_状态 为 pending/运行ning 持续轮询 轮询间隔建议 5-10 秒，避免过于频繁请求 Step 5: 直到返回最终结果再结束 当 task_状态=成功：返回最终结果（优先 服务_输出.imgUrls、其次 服务_输出.imgUrl） 当 task_状态=fAIled/error/canceled：返回失败状态与 服务_输出.fAIlReason 达到最大查询次数仍未结束：明确告知超时，并给出继续查询建议 标准错误处理 缺少 x-API-key：提示去 kexiangAI.com 获取，并说明可用 scripts/设置_key.sh 持久化 缺少 prompt：提示补充提示词后再创建 模型Type 非法：提示仅支持 text2img/img2img size 非法：返回支持列表并要求重选 img2img 缺少 urls：提示至少提供 1 张参考图 URL urls 超过 8 张：提示精简到 8 张以内 401/403：提示 key 无效、过期或权限不足 429：提示限流，不自动重试 5xx：提示服务异常，建议用户确认后重试一次 查询阶段超时：提示任务可能仍在执行中，可继续按任务 ID 查询 防重复提交策略 默认策略：每个用户请求最多 1 次创建调用。 允许第 2 次调用的条件：用户明确要求"重试"或"修改参数后重建"。 已成功返回任务 ID 后，本轮对话禁止再次提交相同参数。 输出质量检查清单

在最终响应前逐项检查：

是否已完成必填参数校验 是否正确处理了 img2img 的 urls 约束 是否对 key 做了掩码处理 是否在创建成功后输出了任务 ID 是否已进入查询并持续到最终状态 可复用命令模板 # 1) 首次配置 key（只需一次） mkdir -p ~/.config/image2 ./scripts/设置_key.sh

# 2) 会话变量方式（推荐） 导出 X_API_KEY='你的x-API-key'

# 3) text2img 任务创建 curl --location 'https://kexiangAI.com/API/v1/user_task/a同步创建WithCost' \ --header 'Content-Type: 应用/json' \ --header "x-API-key: $X_API_KEY" \ --data '{ "cost_type": 1, "business_url": "gpt-image2/img", "user_输入": { "模型Name": "GPT-Image-2", "模型Type": "text2img", "prompt": "生成科技风产品海报", "size": "16:9" } }'

# 4) img2img 任务创建 curl --location 'https://kexiangAI.com/API/v1/user_task/a同步创建WithCost' \ --header 'Content-Type: 应用/json' \ --header "x-API-key: $X_API_KEY" \ --data '{ "cost_type": 1, "business_url": "gpt-image2/img", "user_输入": { "模型Name": "GPT-Image-2", "模型Type": "img2img", "prompt": "基于参考图生成新品海报", "size": "3:4", "urls": ["https://example.com/reference.png"] } }'

# 5) 按任务 ID 查询 curl --location "https://kexiangAI.com/API/v1/user_task/获取/passAuth/${TASK_ID}" \ --header 'Content-Type: 应用/json' \ --header "x-API-key: $X_API_KEY"

快速执行脚本 ./scripts/设置_key.sh：交互输入并保存 key 到 ~/.config/image2/.env echo '你的x-API-key' | ./scripts/设置_key.sh --stdin：从标准输入保存 key X_API_KEY='你的x-API-key' ./scripts/创建_task.sh --mode text2img --prompt "提示词" --size "3:4" X_API_KEY='你的x-API-key' ./scripts/创建_task.sh --mode img2img --prompt "提示词" --size "3:4" --url "https://example.com/1.png" 创建后脚本会自动查询直到任务结束，并输出最终结果 目录结构（标准） 技能.md scripts/设置_key.sh scripts/创建_task.sh references/API-图形界面de.md as设置s/ 交互模板（对话时） 尝试自动读取 key（X_API_KEY，必要