SeeDance 任务 API 集成与使用指南

简介

SeeDance 任务 API 的主要功能是通过输入由 SeeDance 视频生成 API 生成的任务 ID 来查询任务的执行状态。本文将提供详细的集成指导，帮助您轻松集成并充分利用该 API 的强大功能。通过 SeeDance 任务 API，您能够方便地查询 SeeDance 视频生成 API 的任务执行状态。

环境准备/前置条件

在使用 SeeDance 任务 API 之前，您需要在 SeeDance 视频生成 API 页面申请相应的服务，并复制从 SeeDance 视频生成 API 返回的任务 ID。

详细步骤

申请过程

访问 SeeDance 视频生成 API 页面进行服务申请，并获取任务 ID。

然后，前往 SeeDance 任务 API 页面申请相应服务。点击页面上的"Acquire"按钮：

如果您尚未登录或注册，系统将自动重定向到登录页面，请按提示进行操作。首次申请者将获得免费的使用配额。

请求示例

SeeDance 任务 API 可用于查询 SeeDance 视频生成 API 的结果。有关如何使用 SeeDance 视频生成 API 的更多信息，请参考 SeeDance 视频生成 API 文档。

假设我们有一个任务 ID：20068983-0cc9-4c6a-aeb6-9c6a3c668be0，以下将演示如何传入该任务 ID。

设置请求头和请求体

请求头包括：

accept: 指定响应格式为 JSON，设置为 application/json。
authorization: 用于调用 API 的 API 密钥。

请求体包括：

id: 上传的任务 ID。
action: 任务的操作方法。

设置如下：

代码示例

在页面右侧，您可以看到各种语言的代码示例生成，如下图所示：

以下是一些代码示例：

CURL 示例

bash 复制代码

curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0",
  "action": "retrieve"
}'

响应示例

请求成功后，API 将返回任务的详细信息。例如：

json 复制代码

{
    "_id": "69480c5cff2676299c7b351d",
    "id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
    "response": {
        "success": true,
        "task_id": "9462ca25-468b-45a5-9e75-6f516dedcc80",
        "data": {
            "status": "succeeded",
            "video_url": "https://platform.cdn.acedata.cloud/seedance/d1c2e49e-d854-4a2e-b0c0-88e520f82e2e.mp4"
        }
    }
}

返回结果包含多个字段，其中 request 字段是任务发起时的请求体，response 字段是任务完成后的响应体。

批量查询操作

若要查询多个任务 ID 的详细信息，需将操作设置为 retrieve_batch。

请求体包括：

ids: 上传的任务 ID 数组。
action: 任务的操作方法。

设置如下：

CURL 示例

bash 复制代码

curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["id1", "id2"],
  "action": "retrieve_batch"
}'

错误处理

调用 API 时，如果发生错误，API 将返回相应的错误代码和消息。例如：

400 token_mismatched: 错误请求，可能是由于缺少或无效的参数。
401 invalid_token: 未授权，API 密钥无效或缺失。
429 too_many_requests: 请求过多，您已超出请求限制。
500 api_error: 内部服务器错误，服务器发生错误。

错误响应示例

json 复制代码

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  }
}

总结

通过本指南，您已学会如何使用 SeeDance 任务 API 查询单个或批量任务的详细信息。希望本指南能帮助您更好地集成和使用该 API。如有任何疑问，请随时联系技术支持团队。

Visit Ace Data Cloud

技术标签：#SeeDance #API集成 #视频生成 #数据查询 #AceDataCloud