SeeDance 任务 API 集成与使用指南

简介

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

环境准备/前置条件

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

详细步骤

申请过程

  1. 访问 SeeDance 视频生成 API 页面进行服务申请,并获取任务 ID。
  1. 然后,前往 SeeDance 任务 API 页面申请相应服务。点击页面上的"Acquire"按钮:
  1. 如果您尚未登录或注册,系统将自动重定向到 登录页面,请按提示进行操作。首次申请者将获得免费的使用配额。

请求示例

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

相关推荐
万里侯3 小时前
日志聚类之后别把 noise 扔掉:降噪应该改变视图,不抹掉证据
人工智能·微服务·ai·容器·k8s
澹锦汐3 小时前
纯前端秋日银杏与枫叶落叶色板智能聚类器:基于 K-Means 色彩量化与直方图自动配方提取
前端·人工智能·ai·语言模型·vue·react·k-means
最强小杰11 小时前
某 OpenAI 兼容网关上的 `kimi-k3.1-pro`:Cline、Zed 接入与 SSE 排错示例
java·服务器·网络·ai
Maynor99612 小时前
Trymodel 使用介绍:一个平台同时用 Claude、GPT、Gemini 和 Grok
人工智能·gpt·ai·程序员·教程·claude·语音
七夜zippoe12 小时前
多 Agent 通信灾难:状态不一致导致雪崩故障的排查与防护
ai·agent·通信灾难·雪崩故障·排查与防护
Forget the Dream14 小时前
Spring AI 2.0 系列(二):第一个 ChatClient——从注入到一次完整调用
java·人工智能·spring boot·ai·springai
zdr尽职尽责16 小时前
UnityCli 兼容2022版本
ui·unity·ai·c#·游戏引擎
Sharewinfo_BJ21 小时前
从“看数据”到“做决策”:AI时代,BI的下一个形态是什么?
ai·数据分析·bi·智信bi
codigger1 天前
AI 三分钟写完的代码,你凭什么敢直接上线?
ai·程序员·编程·ai编程·#人工智能
wflynn2 天前
Google 观察到首个全自动化网络攻击,AI 框架已能独立完成漏洞利用
ai·技术