高级生图-学员版

要解决什么问题

在 Agent 或课堂环境里「画一张图」「按参考图改风格」时，最容易踩坑的不是提示词，而是 APIMart 生图接口本身：大陆应走 apib.ai 等国内线路，误连已停用的 apimart.ai 会超时；默认 Python User-Agent 常被 403；异步任务要拿 task_id 再轮询，结果字段在 result.images[0].url[0]；图生图还要把本地参考图转成 base64 data URI。自己拼 requests 往往在这些细节上翻车。

技能如何工作

本技能把调用焊死在 scripts/apimart_img.py：固定模型 gpt-image-2，提交后按 data[0].task_id 轮询 /v1/tasks/{id}，完成后下载到本地（默认落在文稿下的 AI生图/日期/）。

• 文生图：提示词 + 可选 --size（如 16:9、1:1，默认竖版 9:16）。
• 图生图：--ref 传本地路径，脚本内转 data URI，不依赖外部图床。
• 网络：三域名顺序兜底 apib.ai → aishuch.com → aixux.com，带正确 UA 与 429/5xx 退避重试。
• Key：读 ~/.image2xueyuan/apimart_key.txt；脚本退出码 2 才提示补 key，避免每次新会话重复盘问。

成功以 stdout 为真实存在的图片路径 为准，stderr 为进度日志。

适用边界与注意点

• 分辨率默认 1k；除非用户明确要求高清，不要主动上 2k/4k（慢、耗积分）。
• 单账号并发约 5～6 张同时在生成，人多时会排队；超时已放宽，排队日志会区分状态。
• 领 API key 可能在网页侧需特殊网络，生图脚本走国内域名，与生图是否 VPN 无关。
• 禁止违法违规、涉政、色情暴力及侵权肖像/名人/品牌类生成。