DeerAPI-API文档
  1. 任务查询
DeerAPI-API文档
  • 帮助中心
    • 模型上新公告
    • 平台通知
    • 帮助中心
    • 快速开始
    • 关于价格
    • 关于分组
    • 接口稳定性
    • 隐私政策
    • 服务条款
    • 报错状态码说明
    • 代码示例
    • 入门必看
    • 常见误区
    • 使用困惑
    • 最佳实践
      • Deerapi 账户余额查询API 使用说明
      • 使用 DeerAPI 和 OpenAI 官方 API 的重试逻辑说明文档
      • Midjorney调用最佳实践
      • Runway调用最佳实践
  • OpenAI格式
    • gpt-4o-image生图
      POST
    • 聊天
      POST
    • 识图
      POST
    • 获取模型列表
      GET
    • 嵌入
      POST
    • 图像
      POST
    • Realtime
      POST
    • 图像编辑(gpt-image-1)
      POST
  • 音频
    • 文本转音频
    • 音频转文本
    • 创建翻译
  • Anthropic 格式
    • Anthropic Claude
  • 音乐生成
    • Suno
      • 设置 suno 版本
      • 生成歌词
      • 生成音乐
      • 上传音乐
      • 歌曲拼接
      • 查询单个任务
      • 批量查询任务
    • Udio(暂不可用)
      • 生成音乐
      • 查询单个任务
  • Midjourney 图像生成
    • 快速教学-完整流程一遍过
    • 任务查询
      • 分页查询
        POST
      • 指定ID获取任务
        GET
    • 提交Imagine任务
      POST
    • 提交Action任务
      POST
    • 提交Blend任务
      POST
    • 提交Describe任务
      POST
    • 提交Modal
      POST
  • 视频生成
    • runway(video)
      • 官方格式
        • 从图像生成视频
        • 获取任务详细信息
      • 逆向格式
        • generate(文本)
        • generate(参考图片)
        • video2video 视频转视频 风格重绘
        • Act-one 表情迁移
        • feed-获取任务
    • kling (video)
      • Callback协议
      • 生成图像
      • 文生视频
      • 图生视频
      • 视频延长
      • 虚拟试穿
      • 对口型
      • 查询任务(单个)
    • luma (video)
      • 官方API格式
        • 生成视频
        • 单个查询任务
    • MiniMax 海螺(video)
      • 官方文档
      • 视频生成
      • 查询任务
      • 文件下载
    • PIKA(video)
      • 通用版
        • generate video
        • 查询视频任务
      • generate(参考视频/扩展视频)
      • generate(参考图片)
      • generate(文本)
      • feed
    • sora
      • 逆向格式
        • 创建视频
        • 生成视频
        • 查询视频任务
  • 图像生成
    • ideogram(images)
      • 官方文档(实时更新)
      • Generate 3.0(文生图)
      • Reframe 3.0(重构)
      • Replace Background 3.0(背景替换)
      • Remix 3.0(混合图)
      • Edit 3.0(编辑)
      • Generate(文生图)
      • Remix(混合图)
      • Upscale(放大高清)
      • Describe(描述)
      • Edit(编辑)
    • Flux(images)
      • 生成图片(replicate格式)
      • 生成图片(暂不可用)
      • 微调(暂不可用)
      • 查询任务
    • Replicate(image)
      • 创建任务
      • 查询任务
    • Recraft(images)
      • 附录
      • Generate Image(生成图片)
      • Vectorize Image(矢量化图片)
      • Remove Background(删除背景)
      • Clarity Upscale(清晰度提升)
      • Create style(创建样式)
      • Generative Upscale(生成高清)
  • 应用集成指南
    • DeerAPI 本站调用
    • OpenManus
    • Chatbox
    • CherryStudio
    • Cursor
    • ChatAll
    • ChatHub
    • COZE
    • FastGPT
    • Lobe-Chat
    • NEXT CHAT (ChatGPT Next Web)
    • cline
    • gptme
    • LangChain
    • AnythingLLM
    • Zotero
    • librechat
    • avante.nvim
    • Dify
    • OpenAI Translator
    • Open WebUI
    • obsidian的text generator插件
    • STranslate
    • 沉浸式翻译
    • Pot 翻译
    • 欧陆翻译
    • utools-ChatGPT 好友
    • GPT 学术优化(gpt_academic)
    • 懒人客服
    • IntelliJ Translation Plugin
  1. 任务查询

指定ID获取任务

GET
https://api.deerapi.com/mj/task/{id}/fetch
快速、稳定地获取单个中途任务的状态。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.deerapi.com/mj/task//fetch' \
--header 'Authorization: Bearer {{api-key}}'
响应示例响应示例
{
  "id": "1747190313867714",
  "action": "IMAGINE",
  "customId": "",
  "botType": "",
  "prompt": "cat",
  "promptEn": "cat",
  "description": "排队中,前面还有19个任务",
  "state": "",
  "mode": "",
  "proxy": "",
  "submitTime": 1747190313868,
  "startTime": 1747190373409,
  "finishTime": 1747190391402,
  "imageUrl": "https://cdn.discordapp.com/attachments/1372025398619279432/1372040685490016286/mira.bilus._cat_e116ba11-6559-4e3a-8792-ce6ff98e8bd4.png?ex=682553f6&is=68240276&hm=07dd4f64e3c5a9783f2ce2bf1e8a8f30e7581c670696aa1a58a64e34faf63976&",
  "imageHeight": 2048,
  "imageWidth": 2048,
  "status": "SUCCESS",
  "progress": "100%",
  "failReason": "",
  "buttons": [
    {
      "customId": "MJ::JOB::upsample::1::e116ba11-6559-4e3a-8792-ce6ff98e8bd4",
      "emoji": "",
      "label": "U1",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::upsample::2::e116ba11-6559-4e3a-8792-ce6ff98e8bd4",
      "emoji": "",
      "label": "U2",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::upsample::3::e116ba11-6559-4e3a-8792-ce6ff98e8bd4",
      "emoji": "",
      "label": "U3",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::upsample::4::e116ba11-6559-4e3a-8792-ce6ff98e8bd4",
      "emoji": "",
      "label": "U4",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::reroll::0::e116ba11-6559-4e3a-8792-ce6ff98e8bd4::SOLO",
      "emoji": "🔄",
      "label": "",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::variation::1::e116ba11-6559-4e3a-8792-ce6ff98e8bd4",
      "emoji": "",
      "label": "V1",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::variation::2::e116ba11-6559-4e3a-8792-ce6ff98e8bd4",
      "emoji": "",
      "label": "V2",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::variation::3::e116ba11-6559-4e3a-8792-ce6ff98e8bd4",
      "emoji": "",
      "label": "V3",
      "type": 2,
      "style": 2
    },
    {
      "customId": "MJ::JOB::variation::4::e116ba11-6559-4e3a-8792-ce6ff98e8bd4",
      "emoji": "",
      "label": "V4",
      "type": 2,
      "style": 2
    }
  ],
  "maskBase64": "",
  "properties": {
    "notifyHook": "",
    "flags": 0,
    "messageId": "1372040685854654507",
    "messageHash": "e116ba11-6559-4e3a-8792-ce6ff98e8bd4",
    "nonce": "1922481632673193984",
    "customId": "",
    "finalPrompt": "cat --fast",
    "progressMessageId": "1372040685854654507",
    "messageContent": "**cat --fast** - <@1365375019445653646> (fast)",
    "discordInstanceId": "1372025398619279432",
    "discordChannelId": "1372025398619279432"
  }
}

请求参数

Path 参数
id
string 
必需
Header 参数
Authorization
string 
可选
示例值:
Bearer {{api-key}}
Body 参数application/x-www-form-urlencoded
object {0}

返回响应

🟢200Success
application/json
Body
id
string 
任务的唯一标识符
必需
action
string 
执行的动作类型
必需
customId
string 
必需
用户自定义的ID,用于追踪或关联,此处为空
botType
string 
必需
使用的机器人类型,此处为空
prompt
string 
必需
用户输入的原始提示语
promptEn
string 
必需
翻译后的英文提示语,模型通常使用英文处理
description
string 
必需
当前任务状态的描述,例如排队信息
state
string 
内部状态码或标识符
必需
mode
string 
必需
任务的执行模式 (例如 Midjourney 中的 'fast', 'relax'),此处为空
proxy
string 
必需
使用的代理服务器信息,此处为空
submitTime
integer 
必需
任务提交时间的时间戳 (毫秒级)
startTime
integer 
必需
任务开始处理的时间戳 (毫秒级)
finishTime
integer 
必需
任务完成的时间戳 (毫秒级)
imageUrl
string 
必需
生成图像的URL地址
imageHeight
integer 
必需
生成图像的高度(像素)
imageWidth
integer 
必需
生成图像的宽度(像素)
status
string 
必需
任务的最终状态,'SUCCESS' 表示成功
progress
string 
必需
任务的完成进度百分比
failReason
string 
必需
如果任务失败,此处会显示失败原因,此处为空表示成功
buttons
array [object {5}] 
必需
与生成结果相关的交互按钮数组
customId
string 
必需
variation: 生成变体
emoji
string 
重新生成的表情符号
必需
label
string 
必需
V4: 基于第四张图生成变体
type
integer 
按钮组件的类型
必需
style
integer 
按钮的样式
必需
maskBase64
string 
必需
Base64编码的蒙版图像数据 (用于图像编辑如inpainting),此处为空
properties
object 
必需
包含与任务相关的其他属性或元数据
notifyHook
string 
必需
Webhook通知URL,用于接收任务状态更新,此处为空
flags
integer 
必需
内部标志位,具体含义需参考API文档
messageId
string 
必需
与此任务关联的消息ID
messageHash
string 
必需
消息内容的哈希值,或用于标识图像的哈希 (用于U/V操作),此处为空
nonce
string 
必需
一次性随机数,用于防止重放攻击或标识请求,此处为空
customId
string 
必需
属性内的自定义ID,此处为空
finalPrompt
string 
必需
经过处理后,最终传递给模型的提示语
progressMessageId
string 
必需
用于显示进度更新的消息ID,此处为空
messageContent
string 
必需
关联消息的内容,此处为空
discordInstanceId
string 
必需
处理请求的Discord实例ID,此处为空
discordChannelId
string 
必需
请求发起或结果发布的Discord频道ID,此处为空
修改于 2025-05-14 02:48:26
上一页
分页查询
下一页
提交Imagine任务
Built with