获取 API Key 获取 API
文档

获取任务状态

- 查询异步任务的执行状态和结果

  • 实时状态更新和进度跟踪
  • 任务完成时获取生成结果
  • 支持多语言返回(zh/en/ko/ja)

请求示例

curl --request GET \
  --url 'https://api.openveer.com/v1/tasks/task-unified-1757156493-imcg5zqt?language=zh' \
  --header 'Authorization: Bearer <token>'

响应示例

{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "cost": 0.15,
    "credits_cost": 1.5,
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.openveer.com/f/image/9998236911693428-e8d7441f-f7b4-4130-97ad-9ef8a0dde2ce-image_task_01KA0413RT2GGNZJ9GWQ4PXF2F_0.png"
          ],
          "expires_at": 1763174708
        }
      ]
    },
    "created": 1763088289,
    "completed": 1763088308,
    "estimated_time": 60,
    "actual_time": 19
  }
}

Authorizations

Authorization string

所有接口均需要使用Bearer Token进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

Path parameters

task_id string

生成API返回的任务ID

Query parameters

language string

返回内容的语言,支持以下值:

  • zh - 中文
  • en - 英文
  • ko - 韩文
  • ja - 日文

默认返回英文

Response

id string

任务唯一标识符

status string

任务状态值:

  • pending - 排队等待处理
  • processing - 处理中
  • completed - 成功完成
  • failed - 失败
  • cancelled - 用户取消
cost number

本次任务扣费金额

credits_cost number

本次任务扣费积分

progress integer

任务进度百分比(0–100)

result object
任务结果,仅在状态为 completed 时返回
images array

生成的图像对象数组(图像生成任务)

videos array

生成的视频对象数组(视频生成任务)

created integer

任务创建时间戳

completed integer

任务完成时间戳(仅在完成时存在)

estimated_time integer

预计完成时间(秒)

actual_time integer

实际完成时间(秒)(仅在完成时存在)

error object
错误详情(仅在状态为 failed 时存在)
code integer

错误代码

message string

错误消息

type string

错误类型