# 接口速查

<a id="endpoint-index"></a>

<a id="接口目录"></a>

## 接口目录

点击查看参数与示例

[POST `/mj/submit/imagine` MJ · Imagine 文生图与垫图 提交文字提示词，可同时提供参考图片。比例和版本等 MJ 参数写在 prompt 内。](https://y.junlistudio.com/docs.md?page=mj-create#mj-imagine)

 

[GET `/mj/task/{id}/fetch` MJ · 查询单个任务 返回裸任务对象，包含任务状态、进度、图片或分析结果及可执行按钮。](https://y.junlistudio.com/docs.md?page=mj-results#mj-fetch)

 

[GET `/mj/image/{id}` MJ · 下载生成图片 图片生成完成后，优先使用任务返回的完整 imageUrl 下载；不要自行拼接图片地址。](https://y.junlistudio.com/docs.md?page=mj-results#mj-image)

 

[POST `/mj/submit/action` MJ · Action 放大、变体与扩图 从父任务 buttons 中选择按钮，原样提交其 customId。成功后继续查询返回的新任务 ID。](https://y.junlistudio.com/docs.md?page=mj-actions#mj-action)

 

[POST `/mj/submit/change` MJ · Change 结构化变化 用动作名称与宫格序号执行放大、变体或重绘。](https://y.junlistudio.com/docs.md?page=mj-actions#mj-change)

 

[POST `/mj/submit/simple-change` MJ · Simple Change 文本变化 将任务 ID 和动作简写放在 content 中。](https://y.junlistudio.com/docs.md?page=mj-actions#mj-simple-change)

 

[POST `/mj/submit/modal` MJ · Modal 局部重绘与自定义 Zoom 先提交父任务的 Vary (Region) / Custom Zoom 按钮，再使用该 Action 回执 result 指向的 Modal 任务补充参数。](https://y.junlistudio.com/docs.md?page=mj-actions#mj-modal)

 

[POST `/mj/submit/describe` MJ · Describe 图生文 上传一张图片，异步获取提示词分析。](https://y.junlistudio.com/docs.md?page=mj-create#mj-describe)

 

[POST `/mj/submit/blend` MJ · Blend 图片混合 将 2–5 张参考图混合生成新图。](https://y.junlistudio.com/docs.md?page=mj-create#mj-blend)

 

[POST `/mj/submit/shorten` MJ · Shorten 提示词分析 分析较长提示词，返回精简建议。](https://y.junlistudio.com/docs.md?page=mj-create#mj-shorten)

 

[POST `/mj/submit/upload-discord-images` MJ · 上传图片并获取 URL 将图片 Data URL 上传为后续可引用的 URL。该接口同步返回，不需要轮询任务。](https://y.junlistudio.com/docs.md?page=mj-results#mj-upload-discord-images)

 

[POST `/mj/submit/edits` MJ · Edits 图片编辑 使用图片 URL 和编辑提示词创建新任务，可附带蒙版。](https://y.junlistudio.com/docs.md?page=mj-actions#mj-edits)

 

[POST `/mj/task/list-by-condition` MJ · 批量查询任务 按任务 ID 列表查询，返回裸任务数组。只查询明确列出的任务，不支持按 state 搜索或列出所有任务。](https://y.junlistudio.com/docs.md?page=mj-results#mj-list)

 

[GET `/mj/task/{id}/image-seed` MJ · 获取图片 Seed 读取原任务对应的 Seed。使用 GET；同时兼容原有 POST 空 JSON 调用。](https://y.junlistudio.com/docs.md?page=mj-results#mj-seed)

 

[GET `/v1/user/balance` 账户余额 API Key 所属用户的剩余积分和累计成功消费](https://y.junlistudio.com/docs.md?page=billing#user-balance)

 

[GET `/v1/models` 模型列表 读取可用模型与支持协议](https://y.junlistudio.com/docs.md?page=models#models)

 

[GET `/admin/api/model-status` 模型状态 公开状态快照，无需 API Key](https://y.junlistudio.com/docs.md?page=model-status#model-status)

 

[POST `/v1/chat/completions` 文本对话 Chat Completions，支持 JSON / SSE 响应](https://y.junlistudio.com/docs.md?page=text#text-completions)

 

[POST `/v1/responses` Responses 文本 文本、工具调用、流式输出和会话续接](https://y.junlistudio.com/docs.md?page=text#text-completions)

 

[POST `/v1/messages` Messages 文本 Anthropic 原生请求与响应](https://y.junlistudio.com/docs.md?page=text#text-completions)

 

[POST `/v1beta/models/{model}:generateContent` Gemini 文本 Gemini 原生请求；流式使用 streamGenerateContent?alt=sse](https://y.junlistudio.com/docs.md?page=text#text-completions)

 

[POST `/v1/images/generations` 文生图 JSON，同步返回图像结果](https://y.junlistudio.com/docs.md?page=images#image-generation)

 

[GET `/v1/image-results/{id}` 读取公开图像 URL 模式返回的临时图像地址](https://y.junlistudio.com/docs.md?page=image-results#image-results)

 

[GET `/v1/images/{id}/content` 读取图像内容 需要 API Key 的图像二进制](https://y.junlistudio.com/docs.md?page=image-results#image-content)

 

[POST `/v1/images/edits` 图生图 multipart/form-data，上传参考图](https://y.junlistudio.com/docs.md?page=image-edit#image-edit)

 

[POST `/v1/responses` 异步生图 后台任务，适合长任务和参考图](https://y.junlistudio.com/docs.md?page=image-tasks#background-image)

 

[GET `/v1/responses/{id}` 查询异步任务 读取状态与 output\[0\].result](https://y.junlistudio.com/docs.md?page=image-tasks#responses-status)

 

[POST `/v1/responses/{id}/cancel` 取消异步任务 取消尚未完成的任务](https://y.junlistudio.com/docs.md?page=image-tasks#responses-status)

 

[POST `/v1/videos` 创建视频任务 JSON 或 multipart，立即返回 queued](https://y.junlistudio.com/docs.md?page=video#video-generation)

 

[GET `/v1/videos/{id}` 查询视频状态 轮询至 completed 或 failed](https://y.junlistudio.com/docs.md?page=video-results#video-status)

 

[GET `/v1/videos/{id}/content` 下载视频 返回 mp4 原始二进制](https://y.junlistudio.com/docs.md?page=video-results#video-content)