API 使用
图片、视频与异步任务
区分体验中心受控媒体工具、同步响应与任务日志中的异步状态
目标
在不依赖旧媒体模式或静态模型清单的前提下，判断媒体请求是否由体验中心 Agent 工具发起，以及结果应查使用日志还是任务日志。
前置条件
- 已在模型广场和可用渠道确认当前媒体能力与 endpoint。
- 已设置明确预算和输出规模限制。
- 体验中心保持“媒体生成前需要确认”开启。
准确入口
- 体验中心：https://infinitex.pro/playground
- 模型广场：https://infinitex.pro/pricing
- 任务日志：https://infinitex.pro/usage-logs/task
- 使用日志：https://infinitex.pro/usage-logs/common
操作步骤
- 先在模型广场和可用渠道确认媒体能力、实时价格、请求地址和同步/异步边界。
- 在体验中心描述目标；主 Agent 只有在需要时才选择图片或视频工具。
- Agent 请求媒体生成确认时，检查模型、预计动作和计费影响后决定是否继续。
- 客户端立即拿到完整结果时在使用日志核对；返回任务 ID或处于等待状态时转到任务日志。
- 异步任务按任务 ID观察状态，不因客户端超时就重复提交。
- 失败时记录任务 ID或 request ID、时间、模型/能力和状态，不公开 prompt、响应或媒体 URL。
成功结果
你能识别请求是同步还是异步，知道应查看哪一种日志；媒体生成经过明确确认，任务完成后费用可核对。
常见错误
| 现象 | 可执行检查 |
|---|---|
| 旧教程要求切换独立图片/视频模式 | 当前体验中心是主 Agent 工作台，不使用旧模式说明 |
| 客户端超时 | 先查任务日志，不立即重发 |
| 任务日志为空 | endpoint 可能是同步请求，改查使用日志 |
| 任务失败 | 核对输入限制、额度、模型能力、渠道和状态页 |
| 费用重复 | 检查是否因超时或轮询错误重复提交 |
安全与计费影响
媒体请求通常比最小文本请求更昂贵，且异步任务可能在客户端断开后继续计费。完整 prompt、输入媒体、生成内容、媒体原始 URL 和上游响应不得进入公开截图。
下一步
最后更新于