图片生成

两个端点均为同步：请求会等待生成完成后返回，无需创建任务或轮询。不同模型使用不同请求协议与响应结构，必须按模型解析，不能假设所有图片接口都返回同一种响应体。

快速开始

curl https://api.vibelab.me/v1/images/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "Doubao-seedream-4.5", "prompt": "白底上的蓝色圆形图标"}'

{"created": 1719820800, "data": [{"url": "https://..."}]}

响应格式因模型而异，见响应。API Key 应只保存在服务端。请求头统一为：

Authorization: Bearer <your-api-key>
Content-Type: application/json

模式选择

POST /v1/images/generations

此端点承载文生图与参考图生成/编辑，可用参数由模型决定。

Seedream 的 data[] 返回 URL 还是 Base64 取决于请求的响应格式与模型线路。

详见 Seedream 与 Wan。

POST /v1/images/edits

此端点用于 gpt-image-2-ext 单图编辑，使用 multipart 表单。

完整请求结构与示例见 GPT Image。

模型选型

请求结构

全部图片模型都使用顶层字段：model 与 prompt 为主要输入，参考图和生成选项位于请求体顶层。GPT Image、Nano Banana、Grok Imagine 和其他 OpenAI Images 扩展模型的具体请求和响应以 GPT Image、Nano Banana、Grok Imagine 和 其他图片模型 页面为准。

请求参数

公共规则（各模型的完整字段见模型页）：

• 请求体最多读取前 20 MiB，超出会被截断，通常因 JSON 不完整返回 400 invalid_request。
• 除上述平台读取的字段外，其余字段原样转发给模型服务校验，越界通常表现为 502 upstream_error。
• 仅 gpt-image-2-ext 的 /v1/images/edits 使用 multipart/form-data（单数 image 文件字段），其余模型一律 JSON。

响应

• 成功响应体由模型服务透传，平台不向响应体注入请求 ID；请求 ID 位于响应头 X-Request-Id，排查时请一并保存。
• 响应中的 usage 是模型服务用量，不是 credit 金额。

计费

图片按平台识别到的输出张数计费，不同模型单价见定价页。

• 请求前按模型、数量和尺寸预扣；成功后按可识别的实际图片数结算。
• 2xx 响应结构无法识别图片数时，按本地解析的提交数量结算。
• 模型服务非 2xx、没有可处理资源或重试耗尽，全额退款。
• 响应中的 usage 是模型服务用量，不是 credit 金额。
• 失败与退款规则以错误码为准。

错误

错误体为统一信封（type 与 code 相同），不应依赖具体 message 文案编写分支：

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_request",
    "message": "invalid image generation request",
    "request_id": "req_..."
  }
}

保留 request_id 便于排查，完整说明见错误码。

注意事项

• 响应中的图片 URL → 临时地址，收到成功响应后应尽快下载并保存到自己的持久存储；当前公开契约不承诺精确有效时长。
• data[].b64_json → 由调用方解码并保存。
• 不同模型的响应体 → 结构不同，必须按模型解析，不能假设所有图片接口返回同一种响应体。