卡片

查询任务状态需要认证免费

GET/cards/:taskId

接口说明

⚠️ 注意：本接口目前仍在迭代开发中，暂时无法正常使用。请勿在生产环境中调用。

根据任务 ID 查询卡片生成任务的执行状态和结果。

主要用途：

查询任务是否完成
获取生成的卡片图片 URL
查看任务执行过程中的错误信息

路径参数：

taskId：任务 ID，由提交任务接口返回

返回值：

id：任务 ID
status：任务状态
- pending：任务处理中
- completed：任务已完成
- failed：任务失败
type：任务类型，固定为 card
outputUrl：生成的卡片图片 CDN 地址，仅当 status 为 completed 时有值
error：错误信息，仅当 status 为 failed 时有值
createdAt：任务创建时间（ISO 8601 格式）

错误说明：

HTTP 状态码	含义
404	任务不存在

调用建议：

提交任务后建议每隔 1-2 秒轮询一次
当 status 变为 completed 或 failed 时停止轮询
无需认证即可查询，但 taskId 需要由提交任务接口获取

授权说明：

此接口无需 API Key 认证（ taskId 本身即作为访问凭证）

请求头

参数类型必填说明

Authorizationstring是

从 Memene API 开放平台获取的 API Key。是 Bearer Token 格式，例如：Bearer sk_memene_xxx_yyy。可以点击此处获取 API KEY

请求参数

参数类型必填说明

taskIdstring是

任务 ID

响应结构

200

Default Response

application/json

字段类型说明

idstring

statusstring

typestring

outputUrlstring

errorstring

createdAtstring

示例

json

{
  "id": "task_abc123",
  "status": "completed",
  "type": "card",
  "outputUrl": "https://cdn.memenews.cn/cards/task_abc123.png",
  "error": null,
  "createdAt": "2025-03-15T08:30:00Z"
}

404

Default Response

application/json

字段类型说明

errorstring

taskIdstring

示例

json

{
  "error": "Task not found",
  "taskId": "task_not_exist"
}