生成工作台

生成工作台是 1XM.AI 后台里的图片和视频生成测试入口。你可以在控制台里选择自己创建的 API Key，直接提交图片或视频生成任务，查看任务状态、轮询结果和返回内容。

提示

生成工作台适合调试提示词、验证 API Key 权限、检查模型返回格式。生产环境接入仍建议参考对应模型的 API 文档。

入口

text

控制台 -> 生成工作台

页面包含两个区域：

区域	说明
图片生成	测试 `gpt-image-2`、`nano-banana-2`、`nano-banana-pro`
视频生成	测试 `seedance2-fast` 以及其它兼容视频模型

API Key 选择

生成工作台会读取你自己创建的 API Key 列表。提交任务时，页面会使用你选择的 Key 直接调用 1XM 的公开 API：

text

Authorization: Bearer sk-你的Key

页面不会展示完整 API Key，也不会把完整 Key 写入本地持久化存储。它的作用是帮你在后台快速验证这个 Key 是否能正常创建任务和查询结果。

素材上传

页面里所有需要填写 URL 的素材字段都支持手动输入、选择文件和拖拽文件：

字段	文件处理方式
图片生成的参考图	浏览器本地转成 `data:image/...;base64,...` 后提交
视频首帧图	上传到 1XM 素材存储后自动填入公开 URL
视频参考图	上传到 1XM 素材存储后追加公开 URL
视频参考视频	上传到 1XM 素材存储后追加公开 URL

图片生成接口的参考图仍然遵循异步图片任务规则，只接收 data URL。视频素材字段会使用上传后的公开 URL，方便直接验证上游视频模型。

支持模型

图片模型

页面名称	实际模型 ID	推荐场景
GPT-Image-2	`gpt-image-2`	OpenAI 兼容图片生成、图片编辑、产品图和海报
Nano Banana 2	`gemini-3.1-flash-image-preview`	快速生图、商品图、社媒素材
Nano Banana Pro	`gemini-3-pro-image-preview`	高质量海报、多参考图融合、角色一致性

视频模型

页面默认值	说明
`seedance2-fast`	默认视频模型示例

视频模型名支持手动输入。平台后续接入新的兼容视频模型时，可以直接在工作台里填写对应模型名测试。

图片生成任务

生成工作台的图片 tab 使用异步任务接口：

text

POST /v1/images/tasks
GET /v1/images/tasks/{task_id}

请求示例

bash

curl -X POST "https://api.1xm.ai/v1/images/tasks" \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张高级科技产品海报，白色背景，真实摄影风格",
    "size": "1:1",
    "quality": "high"
  }'

使用 Nano Banana 2：

json

{
  "model": "gemini-3.1-flash-image-preview",
  "prompt": "生成一张电商主图，白底，真实摄影风格",
  "size": "1:1",
  "quality": "2K"
}

使用 Nano Banana Pro：

json

{
  "model": "gemini-3-pro-image-preview",
  "prompt": "参考品牌视觉生成一张高质量广告海报",
  "image": [
    "data:image/png;base64,..."
  ],
  "size": "16:9",
  "quality": "4K",
  "options": {
    "seed": 123
  }
}

异步图片任务的参考图只接收 data:image/...;base64,...。不要直接传远程图片 URL；请先由你的服务端下载图片、校验大小和格式，再转成 data URL。

查询结果

bash

curl "https://api.1xm.ai/v1/images/tasks/task_xxx" \
  -H "Authorization: Bearer sk-你的Key"

任务完成后，从响应里的图片 URL 字段读取结果。不同上游可能返回 result.images、data[].url 等结构，工作台会尽量自动识别并展示预览。

视频生成任务

生成工作台的视频 tab 使用异步视频接口：

text

POST /v1/videos
GET /v1/videos/{task_id}

注意

POST /v1/videos 是异步创建任务接口，不会同步返回最终视频。创建成功只代表任务已提交，需要继续轮询查询接口。

文本生成视频

bash

curl -X POST "https://api.1xm.ai/v1/videos" \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2-fast",
    "prompt": "一只龙虾在海边跳舞，夕阳，电影感，16:9",
    "options": {
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

图片生成视频

json

{
  "model": "seedance2-fast",
  "prompt": "让图片里的主体自然转身，镜头轻微推进",
  "options": {
    "duration": 5,
    "aspect_ratio": "16:9",
    "first_frame_url": "https://example.com/first-frame.jpg",
    "reference_image_urls": [
      "https://example.com/ref.png"
    ]
  }
}

参考视频

json

{
  "model": "seedance2-fast",
  "prompt": "参考视频动作节奏生成产品展示视频",
  "options": {
    "duration": 5,
    "aspect_ratio": "16:9",
    "reference_video_urls": [
      "https://example.com/ref.mp4"
    ]
  }
}

轮询逻辑

生成工作台会自动轮询任务状态：

类型	轮询间隔	自动停止
图片任务	约 2 秒	完成、失败或超过 10 分钟
视频任务	约 5 秒	完成、失败或超过 20 分钟

如果自动轮询停止，你可以点击“继续刷新”重新查询当前任务。

常见状态：

状态	说明
`pending` / `queued`	任务已创建，等待处理
`running` / `in_progress`	正在生成
`completed` / `succeeded`	已完成
`failed`	生成失败

高级参数

工作台里的“高级参数”需要填写 JSON 对象，会合并到请求的 options 中。

示例：

json

{
  "seed": 123,
  "negative_prompt": "低清晰度、变形",
  "generate_audio": true
}

如果高级参数和页面表单里的固定字段冲突，页面表单字段优先生效。例如视频时长在表单里填写 5，高级参数里填写 "duration": 8，最终会使用 5。

与正式 API 文档的关系

生成工作台用于后台测试和调试。正式接入请继续参考：

如果你要把图片或视频能力集成到自己的产品里，建议优先使用异步任务接口，避免长耗时请求被浏览器、网关或代理超时打断。

生成工作台 ​

入口 ​

API Key 选择 ​

素材上传 ​

支持模型 ​

图片模型 ​

视频模型 ​

图片生成任务 ​

请求示例 ​

查询结果 ​

视频生成任务 ​

文本生成视频 ​

图片生成视频 ​

参考视频 ​

轮询逻辑 ​

高级参数 ​

与正式 API 文档的关系 ​

生成工作台

入口

API Key 选择

素材上传

支持模型

图片模型

视频模型

图片生成任务

请求示例

查询结果

视频生成任务

文本生成视频

图片生成视频

参考视频

轮询逻辑

高级参数

与正式 API 文档的关系