agent-im 会话（生图 / 生视频） 通过 agent-im 的 OpenAPI 创建会话、发送消息（生图、生视频等）、上传图片/视频文件，并查询会话消息进展。 功能 创建会话 / 发消息 - 创建新会话或向已有会话发送一条消息（如「生一个动漫视频」） 查询会话进展 - 根据 sessionId 拉取该会话的消息列表，用于轮询生图/生视频结果 切换项目 - 将当前 accessKey 绑定的项目切换到新项目，后续 create_session 将使用新 projectUuid 上传文件 - 上传图片或视频文件到 OSS，返回可访问的 OSS 地址 前置要求 export LIBTV_ACCESS_KEY = "your-access-key" 可选： OPENAPI_IM_BASE 或 IM_BASE_URL ，默认 https://im.liblib.tv 。 无需安装额外依赖，仅使用 Python 标准库。 使用方法 1. 创建会话 / 发送消息
创建新会话并发送「生一个动漫视频」
python3 { baseDir } /scripts/create_session.py "生一个动漫视频"
向已有会话发送消息
python3 { baseDir } /scripts/create_session.py "再生成一张风景图" --session-id SESSION_ID
只创建/绑定会话，不发消息
python3 { baseDir } /scripts/create_session.py 2. 查询会话进展
查询会话消息列表
python3 { baseDir } /scripts/query_session.py SESSION_ID
增量拉取（只返回 seq 大于 N 的消息）
python3 { baseDir } /scripts/query_session.py SESSION_ID --after-seq 5
附带项目地址（传入 create_session 返回的 projectUuid，结果中带 projectUrl）
python3 { baseDir } /scripts/query_session.py SESSION_ID --project-id PROJECT_UUID 3. 切换项目
切换当前 accessKey 绑定的项目（后续创建会话将使用新项目）
python3 { baseDir } /scripts/change_project.py 4. 上传文件 当用户提供了参考的文件地址时，进行上传，仅支持图片、视频，文件大小必须在200M以下。
上传图片
python3 { baseDir } /scripts/upload_file.py /path/to/image.png
上传视频
python3
{
baseDir
}
/scripts/upload_file.py /path/to/video.mp4
输出格式
create_session
返回：
{
"projectUuid"
:
"aa3ba04c5044477cb7a00a9e5bf3b4d0"
,
"sessionId"
:
"90f05e0c-..."
,
"projectUrl"
:
"https://www.liblib.tv/canvas?projectId=aa3ba04c5044477cb7a00a9e5bf3b4d0"
}
query_session
返回：
{
"messages"
:
[
{
"id"
:
"msg-xxx"
,
"role"
:
"user"
,
"content"
:
"生一个动漫视频"
}
,
{
"id"
:
"msg-yyy"
,
"role"
:
"assistant"
,
"content"
:
"..."
}
]
,
"projectUrl"
:
"https://www.liblib.tv/canvas?projectId=..."
}
（
projectUrl
仅在传入
--project-id
时存在）
change_project
返回：
{
"projectUuid"
:
"新项目UUID"
,
"projectUrl"
:
"https://www.liblib.tv/canvas?projectId=新项目UUID"
}
upload_file
返回：
{
"url"
:
"https://libtv-res.liblib.art/claw/{projectUuid}/{uuid}.png"
}
最终向用户展示时（OpenClaw）
视频地址
：来自
query_session
返回的
messages
中 assistant 消息的 content 或结果里的视频/图片 URL，即「返回的结果」。
项目地址
：使用
create_session
返回的
projectUrl
，或自行拼接
https://www.liblib.tv/canvas?projectId=
+
projectUuid
。查询进展时若传入
--project-id PROJECT_UUID
，
query_session
会直接返回
projectUrl
，便于一并展示。
在任务完成时，同时给出：
视频/图片结果链接
+
项目画布链接（projectUrl）
。
过程中，不要给出
项目画布链接（projectUrl）
。
注意事项
鉴权方式为请求头
Authorization: Bearer