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 文档。假设我们有一个任务 ID20068983-0cc9-4c6a-aeb6-9c6a3c668be0以下将演示如何传入该任务 ID。设置请求头和请求体请求头包括accept: 指定响应格式为 JSON设置为application/json。authorization: 用于调用 API 的 API 密钥。请求体包括id: 上传的任务 ID。action: 任务的操作方法。设置如下代码示例在页面右侧您可以看到各种语言的代码示例生成如下图所示以下是一些代码示例CURL 示例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 将返回任务的详细信息。例如{ _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 示例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: 内部服务器错误服务器发生错误。错误响应示例{ success: false, error: { code: api_error, message: fetch failed } }总结通过本指南您已学会如何使用 SeeDance 任务 API 查询单个或批量任务的详细信息。希望本指南能帮助您更好地集成和使用该 API。如有任何疑问请随时联系技术支持团队。Visit Ace Data Cloud技术标签#SeeDance #API集成 #视频生成 #数据查询 #AceDataCloud