Skip to main content
DimiLinks 的图片接口不是 APIMart 的完全复制，但保留了常用兼容入口。你可以按需开启 APIMart 风格响应。

​
开启方式

任一查询参数命中即可： 
?compat=apimart
?response_schema=apimart
?schema=apimart
?format=apimart
?apimart=true
也可以使用请求头： 
X-Response-Format: apimart
X-API-Format: apimart
X-Compat-Mode: apimart

​
异步提交示例

curl "https://dimilinks.com/v1/images/generations?async=true&compat=apimart" \
  -H "Authorization: Bearer $DIMILINKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张未来城市概念图",
    "size": "16:9",
    "resolution": "2k"
  }'
响应： 
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "img_xxx"
    }
  ]
}

​
主要差异

项目DimiLinks 当前行为
异步提交默认 {created, task_id, data: []}；APIMart 模式才返回 {code,data}。
任务查询推荐 /v1/tasks/{task_id}，状态为 queued、in_progress、succeeded、failed。
参考图数量当前最多 4 张。
图片 URL可能返回相对路径 /p/img/...，调用方需要补齐 origin。
n接口接受 1 到 4；当前建议产品默认 n=1。
response_format建议消费 data[].url，不要依赖 b64_json。

​
APIMart 风格错误

APIMart 兼容模式下仍使用 error 包装，但 code 会变成 HTTP 状态码： 
{
  "error": {
    "message": "参数错误：size 不合法 / 4K 比例不支持 / 像素违规等",
    "type": "invalid_request_error",
    "code": 400
  }
}