EasyAPI
文档

异步图片生成 API 参考

适用于耗时较长的绘图模型：先提交任务拿到 task_id，再轮询查询结果。请求体与同步图片接口一致（JSON 或 multipart/form-data）。

字段值
Base URLhttps://token.easyapi.com/v1
认证Authorization: Bearer `API_KEY`
示例模型dall-e-3
格式REST JSON（异步任务）
计费按量计费
注意： 任务状态：NOT_START（已创建）、IN_PROGRESS（生成中）、SUCCESS（完成，images 含图片结果）、FAILURE（失败，见 fail_reason）。建议每隔约 2 秒轮询，直至离开 NOT_START / IN_PROGRESS。

示例模型

下文均以 dall-e-3（DALL·E 3）为例；更换其他模型时，请替换 model 参数，并参考控制台模型说明调整 size、quality 等字段。

创建任务

POSThttps://token.easyapi.com/v1/images/tasks

提交异步图片生成任务，立即返回 task_id 与初始状态。请求体字段与同步端点（文生图 / 图生图）完全一致，支持 application/json 或 multipart/form-data。

请求参数

名称位置类型必选说明
Authorizationheaderstring是EasyAPI API Key。格式：Bearer `API_KEY`
Content-Typeheaderstring是application/json 或 multipart/form-data

请求体

名称类型必选说明
modelstring是图像模型 ID，与同步接口相同
promptstring是图像文本描述
ninteger否生成张数，默认 1
sizestring否输出尺寸，需与模型支持范围一致
response_formatstring否url 或 b64_json（依模型支持）
imagefile否图生图时上传的参考图（multipart/form-data）

示例

{
  "model": "dall-e-3",
  "prompt": "一只金毛犬在阳光明媚的海滩上奔跑，水彩插画风格，柔和光线",
  "n": 1,
  "size": "1024x1024"
}

返回示例

{
  "code": "success",
  "data": {
    "task_id": "task_img_7c2f9a1b3e4d5c6a8b9f0e1d2c3a4b5",
    "status": "NOT_START",
    "action": "IMAGE_GENERATION",
    "quota": 2000
  }
}

查询任务

GEThttps://token.easyapi.com/v1/images/tasks/{task_id}

示例请求： https://token.easyapi.com/v1/images/tasks/task_img_7c2f9a1b3e4d5c6a8b9f0e1d2c3a4b5

按 task_id 查询任务状态。status 为 SUCCESS 时，data.images 为标准 OpenAI Image Response 数组（含 url / b64_json / revised_prompt）。

请求参数

名称位置类型必选说明
Authorizationheaderstring是EasyAPI API Key。格式：Bearer `API_KEY`
task_idstring是创建任务时返回的 task_id

返回示例

{
  "code": "success",
  "data": {
    "task_id": "task_img_7c2f9a1b3e4d5c6a8b9f0e1d2c3a4b5",
    "status": "SUCCESS",
    "images": [
      {
        "url": "https://cdn.example.com/images/img_dalle3_7c2f9a1b.png",
        "b64_json": "",
        "revised_prompt": "A golden retriever running on a sunny beach, watercolor illustration style"
      }
    ]
  }
}