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: <JWT>，不要添加 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 后执行：

bash

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

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

bash

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

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

接口请求体#

创建项目：

json

{
  "appId": 100100
}

提交文生图任务：

json

{
  "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。
• 不要编造成功结果或图片地址。