图像生成 API
提交图像任务、查询状态并获取受保护的结果
图像生成与聊天调用不同。先确认模型详情已核验为“图像生成”且支持 image-generation 端点，再使用模型详情中的精确调用 ID。模型尺寸、编辑模式和其他参数因模型而异，下面只示范最低限度的文生图请求。
当前已启用的新分档计费规格为 z-image-turbo 单张方形图片。DEELINK_API_BASE_URL 包含 /v1，本地默认为 http://localhost:3001/v1，不是网页的 3000 端口。参数配置或上游支持某个规格，不代表本站已经启用其计费。
curl "$DEELINK_API_BASE_URL/images/generations" \
-H "Authorization: Bearer $DEELINK_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: <你生成的唯一请求键>" \
-d '{
"model": "<已启用图像模型 ID>",
"prompt": "A green film clapperboard on a clean studio desk"
}'若模型返回异步任务，用 DGlink 响应中的公开 task_... ID 查询；不要使用上游任务 ID：
curl "$DEELINK_API_BASE_URL/tasks/task_替换为公开任务号" \
-H "Authorization: Bearer $DEELINK_API_KEY"同一个用户以相同 Idempotency-Key 重试同一个请求体时，DGlink 会复用提交结果；不要把同一个键用于不同内容。任务结果与下载也可在客户“AI 任务”页面查看。提交成功不等于生成成功，费用以任务最终结算状态和用量记录为准。客户端不能指定 callback_url 或 webhook_url，请轮询 DGlink 任务接口。
已核验的网页参数配置
以下仅是网页测试子集，不代表全部图像模型的 API 能力。表单和 JSON 共用校验；提示词去除首尾空白后最多 2000 字符。
| 精确型号 | 已实现参数 |
|---|---|
z-image-turbo | 单张图片；size 仅允许 1:1（默认）；可选整数 seed：1–2147483647。不接受其他比例、自定义像素尺寸、n 或参考图 |
gpt-image-1.5 | size：1:1（默认）、2:3、3:2、1024x1024、1024x1536、1536x1024；quality：low（网页默认）、medium、high；整数 n：1–4，默认 1；可选 image_urls：1–4 个 HTTPS URL |
GPT Image 数量及参考图上限是更保守的本站限制，不是上游最大值。参考图用于图像编辑；Z Image 不开放参考图。其他型号须逐一适配后才能网页提交。2026-09-27 核对依据：Z Image 契约、GPT Image 1.5 API 参数。
参考 URL 安全策略
GPT Image 的参数配置不表示当前已开放调用；还需要对应的分档扣费接入与正式价格发布。未启用时，网页及客户 API 均会拒绝提交。
运营需配置 DEELINK_PLAYGROUND_REFERENCE_HOSTS，值为逗号分隔的受控 CDN 精确域名，不支持通配符。未配置时拒绝所有参考图提交。URL 必须为 HTTPS、最多 2048 字符，不允许凭据、自定义端口、片段、IP 字面量或本地域名。提交前检查所有 DNS 结果，拒绝内网/特殊地址及解析失败。网页不抓取或预览参考素材。只应配置能控制内容及重定向的域名；本地校验无法固定上游稍后访问时的 DNS 或重定向。文件格式、大小及尺寸由上游校验，本地不作保证。
已发布售价、登录、同源、可用渠道及 Gateway 扣费门禁保持不变。基础售价不是数量/画质/参考图组合的请求报价，JSON 不能绕过门禁。网页请求结构为 { "modelId": "<目录 ID>", "parameters": { "prompt": "..." }, "requestId": "<UUID>" }；服务端补齐默认值并拒绝未知字段。结果不确定时，仅同一次请求可复用 UUID。共享网页提交接口的 JSON 请求体限制为256 KiB；图像提示词、参考 URL 数量等仍按具体型号的更小参数上限校验。