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-v2Fun-NB pro:tencent-gem-banana-proFun-NB 2.0:tencent-gem-banana2即梦 5.0:doubao-seedream-5.0即梦 4.5:doubao-seedream-4.5即梦 4.0:doubao-seedream-4.0Qwen-Image-2.0:qwen-image-2.0Wan 2.7:wan2.7-imageWan 2.6:wan2.6-image
比例:16:9、9:16、4:3、3:4、1:1。
清晰度:1K、2K、4K。
生成数量:1 到 4。
执行流程
- 规范化模型名称。用户未指定模型,或写
GPT、GPT-image2、Fun-GP-image2时,统一使用tencent-gpt-img-v2。 - 获取 token。优先读取已保存的本地 token;首次缺失时引导用户从
https://ai.fun.tv/openclaw获取并保存。 - 创建图片项目:
POST /service/workflow/project/appbox/create,请求体为{"appId":100100}。 - 提交文生图任务:
POST /service/workflow/project/appbox/image/task。 - 轮询结果:
GET /service/workflow/resource/project/{userProjectId}?page=1&pageSize=50&projectId={userProjectId}&tabAppCode=text2image,直到taskStatus为SUCCESS。 - 返回
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。
- 不要编造成功结果或图片地址。
