RequestBeam

文档目录

RequestBeam 文档

查询异步任务

查询当前账户创建的异步任务状态与结果。

GEThttps://api.requestbeam.com/v1/jobs/{id}

适用接口

Seedance 2.5 均使用 POST https://api.requestbeam.com/v1/video/seedance 返回 data.jobId，需要使用 GET https://api.requestbeam.com/v1/jobs/{id} 查询任务状态和结果。

或 SSE 直接返回结果，不使用 Jobs。

仅当创建接口响应明确包含 data.jobId 时，才使用本接口。查询时必须使用创建 该任务的同一账户下的 API Key。

text
GET https://api.requestbeam.com/v1/jobs/{id}

验证

http
Authorization: Bearer YOUR_API_KEY

Path 参数

idstring必填

创建任务时返回的数字 jobId。

请求示例

bash
curl --request GET \
  --url https://api.requestbeam.com/v1/jobs/123456789012345678 \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response

idstring

任务 ID。

statusstring

PENDING、CONNECT、PROCESSING、COMPLETED、FAILED 或 CANCELLED。

inputParamsobject

创建任务时提交的输入参数。

outputResultunknown

完成后的输出结果。图片和视频模型的具体结构不同。

createdAtstring

ISO 8601 创建时间。

startedAtstring | null

ISO 8601 开始处理时间。

completedAtstring | null

ISO 8601 完成时间。

成功响应示例

json
{
  "success": true,
  "data": {
    "id": "123456789012345678",
    "status": "COMPLETED",
    "inputParams": {
      "model": "seedance-2.5",
      "prompt": "生成一段 8 秒品牌短片"
    },
    "outputResult": [
      {
        "url": [
          "https://video.example.com/generated/result.mp4"
        ]
      }
    ],
    "createdAt": "2026-08-20T08:24:00.000Z",
    "startedAt": "2026-08-20T08:24:02.000Z",
    "completedAt": "2026-08-20T08:26:30.000Z"
  },
  "requestId": "req_..."
}

轮询建议

  • 建议每 5 到 10 秒查询一次。
  • PENDING、CONNECT 和 PROCESSING 都不是最终状态。
  • COMPLETED 后读取 outputResult。
  • FAILED 或 CANCELLED 后停止轮询。
  • 结果 URL 可能有有效期，请及时保存。

失败响应

完整错误码、协议差异和排查步骤见错误码与错误处理。

任务不存在：

json
{
  "success": false,
  "error": {
    "code": 30000,
    "message": "Job 123456789012345678 not found"
  },
  "requestId": "req_..."
}

无权访问其他账户的任务：

json
{
  "success": false,
  "error": {
    "code": 20001,
    "message": "Access denied"
  },
  "requestId": "req_..."
}