同步接口
接口用途
根据文字提示词生成图片,或结合参考图片进行编辑,并在同一次 HTTP 请求中获取结果。
调用期间需要保持连接,无需创建后轮询任务。
适用场景
同步接口适合已有同步调用流程、需要兼容现有客户端,或所选模型仅支持同步调用的场景。
接入服务应能够保持长连接,并允许较长的响应等待时间。
新项目接入建议优先使用异步接口
尤其在生成耗时较长、批量处理或需要后台展示任务状态时,异步方式可以减少长连接等待带来的超时问题。
异步不会缩短模型生成时间,但更方便持续查询和获取结果。
Base URL
https://api.maomaotoken.com身份认证
在每次请求的 Authorization 请求头中提供 API Key:
Authorization: Bearer YOUR_API_KEY将 YOUR_API_KEY 替换为 MaoMaoToken 提供的实际密钥,保留 Bearer 前缀及其后的空格。
请求端点
以下路径均需拼接到 Base URL 之后。
支持的图片数量、多图参考、局部编辑等能力,以对应模型文档为准。
请求设置
接口默认采用同步模式,无需添加异步参数。
请勿携带 X-Async: true 请求头,不要在 URL 查询参数或 Multipart 表单中设置 async=true,也不要在 JSON 请求体中设置 "async": true。任意一个异步标记生效,都会使请求进入异步模式。
获取结果
请求成功后,接口在本次响应中直接返回图片结果。常见响应结构如下,示例地址仅用于展示:
{
"created": 1788800000,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}实际返回字段以模型文档为准,不保证同时包含 url 和 b64_json。
客户端应检查 HTTP 状态及响应内容,确认取得有效图片结果。
超时与结果保存
同步图片生成可能耗时较长,建议将 HTTP 客户端的响应等待时间设置为 500 秒,并根据模型耗时调整。
该数值是接入建议,不是任务完成时限保证。
下游中转站客户还需检查程序的上游请求超时、Nginx 的 proxy_read_timeout,以及 CDN、负载均衡和程序执行时限。建议外层超时略长于内层,为结果处理和传输留出余量。
请求超时或连接断开不一定意味着生成任务已停止。
同步调用不会返回可用于异步查询的任务编号。请求超时或连接断开后,不能通过异步查询接口获取本次同步结果,请避免立即重复提交。
生成结果的图片地址可能具有有效期,请及时下载保存。排查问题时,请保留调用时间、
模型名称及响应头中的 X-Oneapi-Request-Id。