ai.fun.tv 文生图

ai.fun.tv 文生图

当用户需要根据提示词生成图片时，使用 ai.fun.tv 文生图接口。优先调用本 Skill 附带的脚本执行真实 API 请求；只有调试接口时才手写 cURL。

首次鉴权规则

• 首次使用前，先检查是否已有 token：命令行参数、环境变量 AI_FUN_TV_AUTHORIZATION、或当前 Skill 目录下的 authorization.txt。
• 如果没有 token，引导用户打开 https://ai.fun.tv/openclaw 登录并获取鉴权 token。
• 用户提供 token 后，将 token 保存到当前 Skill 目录下的 authorization.txt，后续任务直接读取该文件，不再重复询问。
• 保存 token 时设置文件权限为仅当前用户可读写；不要在回复、日志或产物中展示完整 token。
• 请求头必须写成 authorization: ，不要添加 Bearer 前缀。

默认参数

• 基础地址：https://ai.fun.tv
• 图片项目 appId：100100
• 文生图 tabAppCode：text2image
• 默认模型名称：Fun-GP-image2
• 默认模型值：tencent-gpt-img-v2
• 模型别名：GPT、GPT-image2、Fun-GP-image2 都映射到 tencent-gpt-img-v2
• 默认比例：16:9
• 默认清晰度：1K
• 默认生成数量：1

可选参数

模型：

• Fun-GP-image2 / GPT / GPT-image2：tencent-gpt-img-v2
• Fun-NB pro：tencent-gem-banana-pro
• Fun-NB 2.0：tencent-gem-banana2
• 即梦 5.0：doubao-seedream-5.0
• 即梦 4.5：doubao-seedream-4.5
• 即梦 4.0：doubao-seedream-4.0
• Qwen-Image-2.0：qwen-image-2.0
• Wan 2.7：wan2.7-image
• Wan 2.6：wan2.6-image

比例：16:9、9:16、4:3、3:4、1:1。

清晰度：1K、2K、4K。

生成数量：1 到 4。

执行流程

1. 规范化模型名称。用户未指定模型，或写 GPT、GPT-image2、Fun-GP-image2 时，统一使用 tencent-gpt-img-v2。
2. 获取 token。优先读取已保存的本地 token；首次缺失时引导用户从 https://ai.fun.tv/openclaw 获取并保存。
3. 创建图片项目：POST /service/workflow/project/appbox/create，请求体为 {"appId":100100}。
4. 提交文生图任务：POST /service/workflow/project/appbox/image/task。
5. 轮询结果：GET /service/workflow/resource/project/{userProjectId}?page=1&pageSize=50&projectId={userProjectId}&tabAppCode=text2image，直到 taskStatus 为 SUCCESS。
6. 返回 data.content[].data.url，如用户要求保存图片，则下载到目标目录。

推荐脚本

首次使用，用户提供 token 后执行：

python3 scripts/generate_text2image.py "高校 AI 提效训练营主视觉海报，年轻学生干部，清爽科技感，正式活动宣传风格" --authorization "用户提供的JWT" --output-dir ./outputs

脚本会自动保存 token。后续使用无需再传 token：

python3 scripts/generate_text2image.py "提示词" --model GPT-image2 --ratio 3:4 --clarity 2K --count 2 --output-dir ./outputs

脚本输出 JSON，包含项目 ID、任务 ID、图片 URL 和本地保存路径。

接口请求体

创建项目：

{
  "appId": 100100
}

提交文生图任务：

{
  "userProjectId": "PROJECT_ID",
  "tabAppCode": "text2image",
  "aspectRatio": "16:9",
  "model": "tencent-gpt-img-v2",
  "clarity": "1K",
  "prompt": "IMAGE_PROMPT",
  "imageCount": 1
}

失败处理

• 如果接口返回非 200 的 code，直接报告完整响应中的 msg 和 requestId。
• 如果轮询超时，报告最后一次 taskStatus 和 taskMessage。
• 如果图片下载失败，仍然返回已生成的远程图片 URL。
• 不要编造成功结果或图片地址。