OpenAI 系列（OG）图像生成提交

使用 POST /v1/videos 提交 image2 系列图像任务。

POST https://magic666.top/v1/videos

curl -X POST https://magic666.top/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image2-high-2k",
    "prompt": "把这个空间重新设计成现代极简风格，保持骨架不变",
    "image": "https://example.com/room.jpg",
    "metadata": {
      "output_image_count": 2,
      "output_config": {
        "width": 2048,
        "height": 2048
      }
    }
  }'

{
  "id": "task_img_abc123",
  "task_id": "task_img_abc123",
  "object": "image.generation.task",
  "status": "QUEUED",
  "model": "image2-high-2k",
  "created_at": 1784788800
}

OpenAI 系列（OG）图像生成提交

方法与路径

POST /v1/videos

请求示例

curl -X POST https://magic666.top/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image2-high-2k",
    "prompt": "把这个空间重新设计成现代极简风格，保持骨架不变",
    "image": "https://example.com/room.jpg",
    "metadata": {
      "output_image_count": 2,
      "output_config": {
        "width": 2048,
        "height": 2048
      }
    }
  }'

请求字段

model · string · required

OpenAI OG 模型名，例如 image2、image2-medium、image2-low、image2-high、image2-high-2k。

prompt · string · required

图像生成或编辑提示词。

image · string

单张参考图 URL 或 Base64。图生图场景常用。

images · string[]

多张参考图。和 image 二选一或按实际模型要求组合使用。

input_reference · object | object[]

结构化参考图输入，用于传递参考图 URL、权重、类型等扩展信息。

metadata.output_image_count · integer

OG / image2 系列输出图片张数。

metadata.output_config · object

输出配置，例如 width、height、aspect_ratio。该配置优先级高于顶层 size。

返回示例

{
  "id": "task_img_abc123",
  "task_id": "task_img_abc123",
  "object": "image.generation.task",
  "status": "QUEUED",
  "model": "image2-high-2k",
  "created_at": 1784788800
}

提交成功后保存 task_id，再调用 任务查询接口 获取最终图片 URL。